Substy Developers
Automations

List fan segments

List the creator's audience segments and their configured matching rules.

GET/v1/agencies/{agencyId}/creators/{creatorId}/segments

List the creator's audience segments and their configured matching rules.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length
creatorId*string

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/segments" \  -H "Authorization: Bearer YOUR_API_KEY"
{  "data": [    {      "type": "PRICE_RANGE",      "creatorId": "string",      "id": "string",      "createdAt": "2019-08-24T14:15:22Z",      "name": "string",      "updatedAt": "2019-08-24T14:15:22Z",      "minValue": null,      "maxValue": null,      "durationValue": null,      "durationUnit": null,      "comparisonOperator": null,      "lastSyncedAt": null,      "lastFullSyncedAt": null    }  ],  "meta": {    "requestId": "string"  }}

Get message export download GET

Get a downloadUrl for a completed message export you requested, identified by jobId. Returns a CSV URL valid for five minutes, expiresAt, rowCount and truncated. Requires current access to every creator included in the export; call get_message_export_status first if completion is uncertain.

Create fan segment POST

Create a creator-specific audience segment with a segment type and supported value or duration conditions.