API endpoints for managing alpha tags as sender IDs for messaging services.
https://rest.clicksend.com/
Request to register an alpha tag. After requested, the alpha tag will be reviewed by ClickSend and either approved or rejected.
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
alpha_tag | string | true | yes | The alpha tag name. Length must be between 3 - 11 characters, can only contain a-z A-Z 0-9 + and must contain at least one non numeric. |
reason | string | false | none | Must be one of the following: Sole Trader Name , Company Name , Partnership Name , Registered Trust Name , Co-Operative Name , Indigenous Corporation Name , Registered Organisation Name , Personal Name , Trademark , Government Agency or Entity , Product or Service Name , Acronym/Initialism , Contraction of Name , Third Party . In case of Third Party , we will contact you to collect the relevant information. |
Refer to Status Codes for definitions of HTTP status code responses.
This endpoint requires authentication, more info...
https://rest.clicksend.com/v3/alpha-tags
curl --include \
--header "Authorization: Basic YXBpLXVzZXJuYW1lOmFwaS1wYXNzd29yZA==" \
--request POST \
--header "Content-Type: application/json" \
--data-binary " {
\"alpha_tag\": \"Abc123+\",
\"reason\": \"Sole Trader Name\"
}" \
'https://rest.clicksend.com/v3/alpha-tags'
{ "id": "db630385-cb76-457d-8f16-76df1b394257", "account_id": "85edb794-ee6d-4a38-9f63-c5fa8acf0d79", "workspace_id": "85edb794-ee6d-4a38-9f63-c5fa8acf0d79", "user_id": "85edb794-ee6d-4a38-9f63-c5fa8acf0d79", "alpha_tag": "Abc123", "status": "PENDING", "reason": "Sole Trader Name", "created_timestamp": "2021-05-11T01:00:00.123Z", "updated_timestamp": "2021-05-11T01:05:00.123Z" }
Get a specific alpha tag.
Parameter | In | Type | Required | Description |
---|---|---|---|---|
alpha_tag_id | path | uuid | true | ID of the alpha tag |
Refer to Status Codes for definitions of HTTP status code responses.
This endpoint requires authentication, more info...
https://rest.clicksend.com/v3/alpha-tags/{alpha_tag_id}
curl --include \
--header "Authorization: Basic YXBpLXVzZXJuYW1lOmFwaS1wYXNzd29yZA==" \
'https://rest.clicksend.com/v3/alpha-tags/db630385-cb76-457d-8f16-76df1b394257'
{ "id": "db630385-cb76-457d-8f16-76df1b394257", "account_id": "85edb794-ee6d-4a38-9f63-c5fa8acf0d79", "workspace_id": "85edb794-ee6d-4a38-9f63-c5fa8acf0d79", "user_id": "85edb794-ee6d-4a38-9f63-c5fa8acf0d79", "alpha_tag": "Abc123", "status": "PENDING", "reason": "Sole Trader Name", "created_timestamp": "2021-05-11T01:00:00.123Z", "updated_timestamp": "2021-05-11T01:05:00.123Z" }
Delete a specific alpha tag.
Parameter | In | Type | Required | Description |
---|---|---|---|---|
alpha_tag_id | path | uuid | true | ID of the alpha tag |
Refer to Status Codes for definitions of HTTP status code responses.
This endpoint requires authentication, more info...
https://rest.clicksend.com/v3/alpha-tags/{alpha_tag_id}
curl --include \
--header "Authorization: Basic YXBpLXVzZXJuYW1lOmFwaS1wYXNzd29yZA==" \
--request DELETE \
'https://rest.clicksend.com/v3/alpha-tags/db630385-cb76-457d-8f16-76df1b394257'