API Unsubscribe

Unsubscribe API

Overview

The Unsubscribe API allows clients to unsubscribe an email address from a specific business's mailing list.

Base URL

https://examplebusiness.com/Api/v1/Unsubscribe

Endpoint

• HTTP Method: POST

• Endpoint: /Api/v1/Unsubscribe

Authentication

This API requires an API key, which should be provided in the x-api-key header.

Enabling Access

To enable this API Key follow the steps denoted on this article: Enable API.

Request Headers

Request Parameters

The following parameters should be passed in the request:

• Parameter Location: Query String (e.g., ?Email=user@example.com).

Example Request

Request URL:

POST https://examplebusiness.com/Api/v1/Unsubscribe?Email=user@example.com

Headers:

codeCache-Control: no-cache
Content-Type: application/json
Accept: application/json
x-api-key: {your_api_key}

Response

The API returns a RestResponse object containing the result of the unsubscribe request.

Success Response

Error Responses

If an error occurs, the response will include an appropriate HTTP status code and error details.

Example Code

Here’s an example of how to call the API in .NET:

Imports RestSharp

Dim rest As New RestClient("https://examplebusiness.com")
Dim request = New RestRequest("Api/v1/Unsubscribe" & "?Email=" &"user@example.com", Method.POST)

request.RequestFormat = DataFormat.Json
request.AddHeader("Cache-Control", "no-cache")
request.AddHeader("Content-Type", "application/json")
request.AddHeader("Accept", "application/json")
request.AddHeader("x-api-key", "your_api_key")

Dim response = rest.Execute(request)

If response.StatusCode = HttpStatusCode.OK Then
    Console.WriteLine("Unsubscription successful.")
Else
    Console.WriteLine("Error: " & response.StatusDescription)
End If

Notes

• Ensure that you replace {examplebusiness.com} with your actual business website URL.

• Ensure that you replace {your_api_key} with the latest you have from the Enabling Access step.

Contact and Support

For additional assistance or to report issues with the API, please contact support@bookingtimes.com or visit our Support Page.