Substy Developers
Inbox and fans

Schedule fan message

Schedule an individual fan message 1–60 minutes from now using delayMinutes, with supported media and paid content. A queued result does not confirm delivery. Direct conversational replies are unavailable through MCP.

POST/v1/agencies/{agencyId}/creators/{creatorId}/fans/{fanId}/scheduled-messages

Schedule an individual fan message 1–60 minutes from now using delayMinutes, with supported media and paid content. A queued result does not confirm delivery. Direct conversational replies are unavailable through MCP.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length
creatorId*string|string
fanId*string|string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/agencies/string/creators/string/fans/string/scheduled-messages" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "delayMinutes": 0,    "message": "string"  }'
{  "data": {    "creatorId": null,    "id": "string",    "createdAt": "2019-08-24T14:15:22Z",    "status": "SENT",    "fanId": "string",    "price": 0,    "updatedAt": "2019-08-24T14:15:22Z",    "traceId": null,    "sentByAi": true,    "sentByEmployeeId": null,    "revertedByEmployeeId": null,    "reverted": true,    "revertedAt": null,    "isBump": true,    "voicePresetId": null,    "automationMessageId": null,    "soloBundleId": null,    "isFollowUp": true,    "followUpType": null,    "priceCurrency": null,    "nativePrice": null,    "documentAttachments": null,    "medias": [      {        "id": "string",        "type": "PHOTO",        "files": {          "full": "string",          "thumb": "string",          "preview": "string"        }      }    ],    "sentByEmployee": null,    "revertedByEmployee": null,    "isAutomationMessage": true,    "automation": null,    "isScriptMessage": true,    "script": null,    "scriptTemplate": null,    "creatorTags": [      {        "id": "string",        "name": "string"      }    ],    "giphyId": null,    "gifUrl": null,    "replyToMessage": null,    "isSentByCreator": true,    "user": null,    "text": "string",    "mediaCount": 0,    "previews": [      "string"    ],    "isPurchasedByRecipient": true,    "isLiked": true,    "isTip": true,    "isRead": true,    "cancelSeconds": 0  },  "meta": {    "requestId": "string",    "operationId": "3051932a-fdd2-48fa-b330-7e7d41535969",    "status": "COMPLETED"  }}

List scheduled fan messages GET

List queued messages for one creator-fan conversation. Use the returned scheduled-message identifier to cancel a pending send.

Cancel scheduled fan message DELETE

Cancel a queued individual fan message using its scheduled-message identifier. This does not unsend a message that has already been delivered.