Substy Developers
Campaigns

List mass messages

List a creator's bulk message campaigns using the supported status and pagination filters.

GET/v1/agencies/{agencyId}/creators/{creatorId}/mass-messages

List a creator's bulk message campaigns using the supported status and pagination filters.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length
creatorId*string

Query Parameters

search?string
Lengthlength <= 200
status?|array<>
dateFrom?string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
dateTo?string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
sortDirection?string
Default"desc"

Value in

  • "asc"
  • "desc"
page?integer
Range1 <= value <= 9007199254740991
Default1
pageSize?integer
Range1 <= value <= 100
Default20

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agencies/string/creators/string/mass-messages" \  -H "Authorization: Bearer YOUR_API_KEY"
{  "data": {    "items": [      {        "creatorId": "string",        "status": "CANCELED",        "id": "string",        "createdAt": "2019-08-24T14:15:22Z",        "updatedAt": "2019-08-24T14:15:22Z",        "price": "string",        "tags": [          "string"        ],        "revertedByEmployeeId": null,        "revertedAt": null,        "revertedByEmployee": null,        "mediaIds": [          "string"        ],        "text": "string",        "scheduledAt": null,        "createdByEmployeeId": null,        "createdByEmployee": null,        "previewIds": [          "string"        ],        "lastSyncedAt": null,        "autoUnsendAfterSeconds": null,        "includedListIds": [          "string"        ],        "excludedListIds": [          "string"        ],        "userIds": [          "string"        ],        "includeOnlineFans": true,        "platformId": null,        "recipientCount": 0,        "sentCount": 0,        "canUnsend": true,        "unsendDeadline": null,        "viewedCount": null,        "purchasedCount": null,        "revenueGrossMinor": null,        "revenueNetMinor": null,        "revenueCurrency": null,        "statsSyncedAt": null,        "gif": null,        "revertedByName": null      }    ],    "total": 0,    "page": 0,    "pageSize": 0,    "totalPages": 0  },  "meta": {    "requestId": "string"  }}

Sync creator tracking links POST

Refresh the creator's locally stored tracking links from the connected platform.

Create mass message POST

Create a bulk campaign for the selected audience, with supported media, PPV price and scheduling. This can send to real fans; inspect the campaign state to determine delivery progress.