# Alibaba Cloud MessageCenter API

> Alibaba Cloud MessageCenter API on Apizie: 31 endpoints (Creates a webhook contact, Deletes a message, Deletes all in-app messages (logical deletion), Deletes a webhook contact, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/cloud:aliyun-notifications/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-notifications`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/notifications
- Page: https://www.apizie.tech/api/cloud/aliyun-notifications
- OpenAPI: https://www.apizie.tech/api/cloud/aliyun-notifications/openapi.json

Alibaba Cloud OpenAPI for MessageCenter (notifications, version 2024-12-25). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Creates a webhook contact
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/create-webhook-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application name of the caller |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the caller |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The user cookies |
| AcceptLanguage | string | no | The language |
| WebhookType | string | no | The webhook type |
| ServerUrl | string | no | The DingTalk group chatbot URL |
| SecurityToken | string | no | The SecurityToken |
| ContactName | string | no | The name of the webhook contact |
| BotSecurityToken | string | no | The webhook security signature token |
| TemplateCode | string | no | The template code |
| VerificationCode | string | no | The verification code |

### Deletes a message
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/del-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | A system parameter. You do not need to specify this parameter |
| CallerProtocol | string | no | A system parameter. You do not need to specify this parameter |
| BizName | string | no | A system parameter. You do not need to specify this parameter |
| TenantCode | string | no | A system parameter. You do not need to specify this parameter |
| UidType | string | no | A system parameter. You do not need to specify this parameter |
| ClientSource | string | no | A system parameter. You do not need to specify this parameter |
| SrcUrl | string | no | A system parameter. You do not need to specify this parameter |
| Cookies | string | no | A system parameter. You do not need to specify this parameter |
| AcceptLanguage | string | no | The language. Default value: zh-CN (Simplified Chinese) |
| MsgId | string | no | The message ID |

### Deletes all in-app messages (logical deletion)
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/delete-all-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | A system parameter. You do not need to specify this parameter |
| CallerProtocol | string | no | A system parameter. You do not need to specify this parameter |
| BizName | string | no | A system parameter. You do not need to specify this parameter |
| TenantCode | string | no | A system parameter. You do not need to specify this parameter |
| UidType | string | no | A system parameter. You do not need to specify this parameter |
| ClientSource | string | no | A system parameter. You do not need to specify this parameter |
| SrcUrl | string | no | A system parameter. You do not need to specify this parameter |
| Cookies | string | no | A system parameter. You do not need to specify this parameter |
| AcceptLanguage | string | no | The language. Default value: Simplified Chinese |
| ClassId | integer | no | The message category ID |
| GroupCode | string | no | The group code |

### Deletes a webhook contact
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/delete-webhook-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application name of the caller |
| CallerProtocol | string | no | The Protocol Type of the request |
| BizName | string | no | The business line of the caller |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The cookies of the user |
| AcceptLanguage | string | no | The language |
| ContactId | integer | no | webhook id |

### Retrieves all common contacts across accounts
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-all-common-contacts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application name of the caller |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the caller |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The user cookies |
| AcceptLanguage | string | no | The language |

### Retrieves all marketing preference configurations
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-all-marketing-preferences` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application name of the caller |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the caller |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The user cookies |
| AcceptLanguage | string | no | The language |

### Marks all messages as read. If no category is specified, all messages are marked as read
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-all-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | A system parameter. You do not need to specify this parameter |
| CallerProtocol | string | no | A system parameter. You do not need to specify this parameter |
| BizName | string | no | A system parameter. You do not need to specify this parameter |
| TenantCode | string | no | A system parameter. You do not need to specify this parameter |
| UidType | string | no | A system parameter. You do not need to specify this parameter |
| ClientSource | string | no | A system parameter. You do not need to specify this parameter |
| SrcUrl | string | no | A system parameter. You do not need to specify this parameter |
| Cookies | string | no | A system parameter. You do not need to specify this parameter |
| AcceptLanguage | string | no | The language. Default value: Simplified Chinese |
| ClassId | integer | no | The message category ID |
| GroupCode | string | no | The group code |

### Retrieves the full list of webhooks
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-all-webhook-contacts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | Ignore. This parameter does not need to be specified. The application name of the caller |
| CallerProtocol | string | no | Ignore. This parameter does not need to be specified. The request protocol type |
| BizName | string | no | Ignore. This parameter does not need to be specified. The business line of the caller |
| TenantCode | string | no | Ignore. This parameter does not need to be specified. The tenant information |
| UidType | string | no | Ignore. This parameter does not need to be specified. The user type |
| ClientSource | string | no | Ignore. This parameter does not need to be specified. The client source of the operation |
| SrcUrl | string | no | Ignore. This parameter does not need to be specified. The URL of the source page |
| Cookies | string | no | Ignore. This parameter does not need to be specified. The user cookies |
| AcceptLanguage | string | no | The language. Automatically passed through by the browser. You can forcefully override this value |

### Retrieves the list of category groups
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-category-group-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | Ignored. You do not need to pass this parameter. The application name of the requester |
| CallerProtocol | string | no | Ignored. You do not need to pass this parameter. The request protocol type |
| BizName | string | no | Ignored. You do not need to pass this parameter. The business line of the requester |
| TenantCode | string | no | Ignored. You do not need to pass this parameter. The tenant information |
| UidType | string | no | Ignored. You do not need to pass this parameter. The user type |
| ClientSource | string | no | Ignored. You do not need to pass this parameter. The operation terminal source |
| SrcUrl | string | no | Ignored. You do not need to pass this parameter. The source page URL |
| Cookies | string | no | Ignored. You do not need to pass this parameter. The user cookies |
| AcceptLanguage | string | no | The language. Automatically passed through by the browser. You can manually override this value |
| ChannelGroupCode | string | no | The channel group |

### Retrieves the number of read messages for each category
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-class-name` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | System parameter. You do not need to specify this parameter |
| CallerProtocol | string | no | System parameter. You do not need to specify this parameter |
| BizName | string | no | System parameter. You do not need to specify this parameter |
| TenantCode | string | no | System parameter. You do not need to specify this parameter |
| UidType | string | no | System parameter. You do not need to specify this parameter |
| ClientSource | string | no | System parameter. You do not need to specify this parameter |
| SrcUrl | string | no | System parameter. You do not need to specify this parameter |
| Cookies | string | no | System parameter. You do not need to specify this parameter |
| AcceptLanguage | string | no | The language. Default value: Simplified Chinese |

### Retrieves a general contact
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-common-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application name of the caller |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the caller |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The user cookies |
| AcceptLanguage | string | no | The language |
| ContactId | integer | no | The contact ID |

### Retrieves the marketing preferences of a user
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-marketing-preference` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application name of the requester |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the requester |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The cookies of the user |
| AcceptLanguage | string | no | The language |
| ContactId | integer | no | The contact ID |

### Marks a message as read
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | System parameter. You do not need to specify this parameter |
| CallerProtocol | string | no | System parameter. You do not need to specify this parameter |
| BizName | string | no | System parameter. You do not need to specify this parameter |
| TenantCode | string | no | System parameter. You do not need to specify this parameter |
| UidType | string | no | System parameter. You do not need to specify this parameter |
| ClientSource | string | no | System parameter. You do not need to specify this parameter |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | System parameter. You do not need to specify this parameter |
| AcceptLanguage | string | no | The language. Default value: zh-CN (Simplified Chinese) |
| MsgId | string | no | The message ID |

### Retrieves the body of a message
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-message-content` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | A system parameter. You do not need to specify this parameter |
| CallerProtocol | string | no | A system parameter. You do not need to specify this parameter |
| BizName | string | no | A system parameter. You do not need to specify this parameter |
| TenantCode | string | no | A system parameter. You do not need to specify this parameter |
| UidType | string | no | A system parameter. You do not need to specify this parameter |
| ClientSource | string | no | A system parameter. You do not need to specify this parameter |
| SrcUrl | string | no | A system parameter. You do not need to specify this parameter |
| Cookies | string | no | A system parameter. You do not need to specify this parameter |
| AcceptLanguage | string | no | The language. Default value: Simplified Chinese |
| MsgId | string | no | The message ID |
| ClassId | integer | no | Deprecated |
| Status | integer | no | The read status. Valid values: 0: unread 1: read |
| History | string | no | Specifies whether the message is a historical message |
| GroupCode | string | no | The group code |

### Retrieves the message language
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-message-language` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | Ignored. This parameter does not need to be specified. The application name of the requester |
| CallerProtocol | string | no | Ignored. This parameter does not need to be specified. The request protocol type |
| BizName | string | no | Ignored. This parameter does not need to be specified. The business line of the requester |
| TenantCode | string | no | Ignored. This parameter does not need to be specified. The tenant information |
| UidType | string | no | Ignored. This parameter does not need to be specified. The user type |
| ClientSource | string | no | Ignored. This parameter does not need to be specified. The operation terminal source |
| SrcUrl | string | no | Ignored. This parameter does not need to be specified. The source page URL |
| Cookies | string | no | Ignored. This parameter does not need to be specified. The user cookies |
| AcceptLanguage | string | no | Ignored. This parameter does not need to be specified. The page language |
| ReturnDefaultLang | string | no | Specifies whether to return the default language. If the value is YES, the default language is returned |

### Retrieves a list of messages
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-message-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | A system parameter. You do not need to specify this parameter |
| CallerProtocol | string | no | A system parameter. You do not need to specify this parameter |
| BizName | string | no | A system parameter. You do not need to specify this parameter |
| TenantCode | string | no | A system parameter. You do not need to specify this parameter |
| UidType | string | no | A system parameter. You do not need to specify this parameter |
| ClientSource | string | no | A system parameter. You do not need to specify this parameter |
| SrcUrl | string | no | A system parameter. You do not need to specify this parameter |
| Cookies | string | no | A system parameter. You do not need to specify this parameter |
| AcceptLanguage | string | no | The language. Default value: Simplified Chinese |
| ClassId | integer | no | Deprecated |
| Status | integer | no | The message status. A value of 1 indicates read. A value of 0 indicates unread. A value of -1 indicates all. Default value: -1 |
| Title | string | no | The message title. This parameter is used for fuzzy match |
| Content | string | no | The message content. This parameter is used for fuzzy match |
| Page | integer | no | The page number for the paged query |
| PageSize | integer | no | The page size for the paged query |
| MaxResults | integer | no | A system parameter. You do not need to specify this parameter |
| NextToken | string | no | A system parameter. You do not need to specify this parameter |
| Loc | string | no | The location |
| History | string | no | Specifies whether the messages are historical messages |
| GroupCode | string | no | The group code |

### Retrieves the total number of unread messages
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-message-new-total` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | System parameter. You do not need to specify this parameter |
| CallerProtocol | string | no | System parameter. You do not need to specify this parameter |
| BizName | string | no | System parameter. You do not need to specify this parameter |
| TenantCode | string | no | System parameter. You do not need to specify this parameter |
| UidType | string | no | System parameter. You do not need to specify this parameter |
| ClientSource | string | no | System parameter. You do not need to specify this parameter |
| SrcUrl | string | no | System parameter. You do not need to specify this parameter |
| Cookies | string | no | System parameter. You do not need to specify this parameter |
| AcceptLanguage | string | no | The language. Default value: Simplified Chinese |

### Retrieves the metadata service
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-meta-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application project name of the requester |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the requester |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The user cookies |
| AcceptLanguage | string | no | The language type of the returned information. Valid values: zh: Chinese. en: English |

### Retrieves the count of read messages for each category
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-num-group-by-class` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | A system parameter. You do not need to specify this parameter |
| CallerProtocol | string | no | A system parameter. You do not need to specify this parameter |
| BizName | string | no | A system parameter. You do not need to specify this parameter |
| TenantCode | string | no | A system parameter. You do not need to specify this parameter |
| UidType | string | no | A system parameter. You do not need to specify this parameter |
| ClientSource | string | no | A system parameter. You do not need to specify this parameter |
| SrcUrl | string | no | A system parameter. You do not need to specify this parameter |
| Cookies | string | no | A system parameter. You do not need to specify this parameter |
| AcceptLanguage | string | no | The language. Default value: Simplified Chinese |

### Method description: Get information under all categories
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-num-group-total` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | System parameter. You do not need to set this parameter |
| CallerProtocol | string | no | System parameter. You do not need to set this parameter |
| BizName | string | no | System parameter. You do not need to set this parameter |
| TenantCode | string | no | System parameter. You do not need to set this parameter |
| UidType | string | no | System parameter. You do not need to set this parameter |
| ClientSource | string | no | System parameter. You do not need to set this parameter |
| SrcUrl | string | no | System parameter. You do not need to set this parameter |
| Cookies | string | no | System parameter. You do not need to set this parameter |
| AcceptLanguage | string | no | The language. Default value: Simplified Chinese |
| Title | string | no | The message title |

### Retrieves revision records
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-revision-history-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | Ignored. No need to pass this parameter. The application name of the caller |
| CallerProtocol | string | no | Ignored. No need to pass this parameter. The request protocol type |
| BizName | string | no | Ignored. No need to pass this parameter. The business line of the caller |
| TenantCode | string | no | Ignored. No need to pass this parameter. The tenant information |
| UidType | string | no | Ignored. No need to pass this parameter. The user type |
| ClientSource | string | no | Ignored. No need to pass this parameter. The source of the operation terminal |
| SrcUrl | string | no | Ignored. No need to pass this parameter. The source page URL |
| Cookies | string | no | Ignored. No need to pass this parameter. The user cookies |
| AcceptLanguage | string | no | The language. Automatically passed through by the browser. You can manually override this value |
| ChannelGroupCode | string | no | The channel group |
| CategoryCode | string | no | The category code |
| PageInfo | string | no | The pagination information (JSON-encoded) |

### Retrieves the subscription list of a user
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-user-subscription-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application project name of the caller |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the caller |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The cookies of the user |
| AcceptLanguage | string | no | The language |
| ChannelGroupCode | string | no | The channel group |
| CategoryGroupCode | string | no | The category group code |

### Retrieves a webhook contact
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-webhook-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The name of the caller application |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the caller |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The user cookies |
| AcceptLanguage | string | no | The language |
| ContactId | integer | no | webhook id |

### Retrieves the list of webhook send templates
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/read-webhook-contact-send-template-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application name of the requester |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the requester |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The user cookies |
| AcceptLanguage | string | no | The language |
| TemplateCode | string | no | The template code |

### Resets user subscriptions
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/reset-user-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application name of the caller |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the caller |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The user cookies |
| AcceptLanguage | string | no | The language |
| ChannelGroupCode | string | no | The channel group. Valid values: tts: Voice reception management. webhook: Bot reception management. base: Basic reception management |
| CategoryCodes | string | no | The list of category codes (JSON-encoded) |
| Remarks | string | no | The remarks |

### Tests a webhook
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/test-webhook-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The name of the caller application |
| CallerProtocol | string | no | The type of the request protocol |
| BizName | string | no | The business line of the caller |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The user cookies |
| AcceptLanguage | string | no | The language |
| ContactId | integer | no | webhook id |
| BotSecurityToken | string | no | The security token |
| ContactName | string | no | The name of the webhook contact |
| WebhookType | string | no | The webhook type |
| ServerUrl | string | no | The webhook server URL |
| TemplateCode | string | no | The template code |

### Updates marketing preferences
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/update-marketing-preference` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application name of the caller |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the caller |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The cookies of the user |
| AcceptLanguage | string | no | The language |
| ContactId | integer | no | webhook id |
| AllowMarketing | string | no | Specifies whether to allow notifications |

### Updates the message language
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/update-message-language` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | Ignore. This parameter does not need to be specified. The application name of the requester |
| CallerProtocol | string | no | Ignore. This parameter does not need to be specified. The request protocol type |
| BizName | string | no | Ignore. This parameter does not need to be specified. The business line of the requester |
| TenantCode | string | no | Ignore. This parameter does not need to be specified. The tenant information |
| UidType | string | no | Ignore. This parameter does not need to be specified. The user type |
| ClientSource | string | no | Ignore. This parameter does not need to be specified. The operation terminal source |
| SrcUrl | string | no | Ignore. This parameter does not need to be specified. The source page URL |
| Cookies | string | no | Ignore. This parameter does not need to be specified. The user cookies |
| AcceptLanguage | string | no | Ignore. This parameter does not need to be specified. The page language |
| PreferLang | string | no | The message language. This parameter is required |

### Updates a user subscription
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/update-user-subscription` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application name of the requester |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the requester |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The user cookies |
| AcceptLanguage | string | no | The language |
| ChannelGroupCode | string | no | The channel group. Valid values: tts: Voice channel group. webhook: Chatbot channel group. base: Basic channel group |
| OperationItemCode | string | no | The revision type. Valid values: receive_contact: Receive contact. receive_channel: Receive channel |
| CategoryCodes | string | no | The list of categories (JSON-encoded) |
| ReceiveTimeList | string | no | Not supported (JSON-encoded) |
| ChannelConfigs | string | no | The list of channels (JSON-encoded) |
| WebhookContacts | string | no | The list of chatbot contacts (JSON-encoded) |
| CommonContacts | string | no | The common contacts (JSON-encoded) |
| Remarks | string | no | The remarks |

### Modifies a webhook contact
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/update-webhook-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |
| AppName | string | no | The application name of the caller |
| CallerProtocol | string | no | The request protocol type |
| BizName | string | no | The business line of the caller |
| TenantCode | string | no | The tenant information |
| UidType | string | no | The user type |
| ClientSource | string | no | The source of the operation terminal |
| SrcUrl | string | no | The URL of the source page |
| Cookies | string | no | The user cookies |
| AcceptLanguage | string | no | The language |
| WebhookType | string | no | The webhook type |
| ServerUrl | string | no | The webhook server URL |
| SecurityToken | string | no | The SecurityToken |
| ContactId | integer | no | webhook id |
| ContactName | string | no | The webhook name |
| BotSecurityToken | string | no | The security signature |
| TemplateCode | string | no | The template code. This parameter is required only for custom webhooks |
| VerificationCode | string | no | The verification code |

### version
`POST https://www.apizie.tech/v1/cloud:aliyun-notifications/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://notifications-intl.aliyuncs.com |

## Example
```
curl "https://www.apizie.tech/v1/cloud:aliyun-notifications/create-webhook-contact" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud MessageCenter API?
Create a free Apizie key, then send POST https://www.apizie.tech/v1/cloud:aliyun-notifications/create-webhook-contact with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud MessageCenter API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud MessageCenter itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud MessageCenter API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-notifications.

### What is the status of the Alibaba Cloud MessageCenter API?
Needs your own provider key (bring your own key)