Skip to main content

POST Create New Subscription Event

Use the endpoint to programmatically create a calendar subscription event and add it to one or more calendar subscriptions.

Description#

This API endpoint will create an event and attach it to one or more calendar subscriptions. The response of 202 Accepted indicates that the response was successfully validated and has been accepted for processing. Events are being created in a background process, it can take up to few minutes for changes to propagate to subscribers' calendars.

Request#

Path

POST /v1/subscriptionevent/{accountCode}

Parameters

NameTypeInDescriptionRequiredExample
accountCodeStringpathThe Rokt Calendar merchant account code, or the subdomain of your Rokt Calendar dashboard URLtrue 

Request body

{  "event": {    "eventId": "string",    "title": "string",    "description": "string",    "location": "string",    "timezone": "string",    "timezoneIanaId": "string",    "start": "2025-10-04T10:00:00.000Z",    "end": "2025-10-04T10:00:00.000Z",    "allDayEvent": true,    "notifyBefore": null,    "actionType": "string"  },  "subscriptionIds": [    "string"  ],  "actionType": "string"}

Response#

202 Accepted

Error#

400 BadRequest

500 InternalServerError

Was this article helpful?