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

Name	Type	In	Description	Required	Example
accountCode	String	path	The Rokt Calendar merchant account code, or the subdomain of your Rokt Calendar dashboard URL	true

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",    "visibleFromDateTimeUtc": "2025-10-03T10:00:00.000Z" // optional  },  "subscriptionIds": [    "string"  ],  "actionType": "string"}

Response

202 Accepted

Error

400 BadRequest

500 InternalServerError