Get Started

Creators

API endpoint for retrieving workspace creators and their account information

GETPOSTPATCHDELETE
POST/creators

Request Body

requiredapplication/json
namestringrequired

Creator name

Example: "John Doe"

Headers

x-api-keystringrequired

Your Track My Posts API key

Query Parameters

workspaceSlugstringrequired

Workspace slug identifier

Example: my-workspace

Responses

201Creator created successfully
400Bad request - validation error
401Unauthorized - authentication required
403Forbidden - insufficient permissions
404Not found - workspace not found
422Unprocessable entity - all accounts failed to be added
500Internal server error
curl "https://api.trackmyposts.com/creators?workspaceSlug=my-workspace" \
  -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "John Doe",
  "accounts": [
    {
      "platform": "tiktok",
      "username": "@johndoe",
      "accountUrl": "https://tiktok.com/@johndoe",
      "hashtagsToTrack": [
        "#fitness",
        "#workout"
      ],
      "mentionsToTrack": [
        "mrbeast"
      ],
      "accountStatus": "active",
      "postsToTrack": 20,
      "paymentRules": [
        {
          "rule": "per_post_flat",
          "amountUsd": 100,
          "percent": null,
          "minViews": null,
          "maxViews": null
        }
      ]
    }
  ]
}'
{
  "ok": true,
  "creatorSlug": 123
}

Data Structures

View all 13 data structuresCreators

Explore all data structures used in this API endpoint