Get Started

Creators

API endpoint for retrieving workspace creators and their account information

GETPOSTPATCHDELETE
PATCH/creators

Request Body

requiredapplication/json
idstring (uuid)required

Creator ID (UUID) to update

Example: "550e8400-e29b-41d4-a716-446655440000"

namestringrequired

Creator name

Example: "John Doe Updated"

Headers

x-api-keystringrequired

Your Track My Posts API key

Query Parameters

workspaceSlugstringrequired

Workspace slug identifier

Example: my-workspace

Responses

200Creator updated successfully
400Bad request - validation error
401Unauthorized - authentication required
403Forbidden - insufficient permissions
404Not found - creator not found
422Unprocessable entity - update failed
500Internal server error
curl "https://api.trackmyposts.com/creators?workspaceSlug=my-workspace" \
  -X PATCH \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "John Doe Updated",
  "accounts": [
    {
      "platform": "tiktok",
      "username": "@johndoe",
      "accountUrl": "https://tiktok.com/@johndoe",
      "hashtagsToTrack": [
        "fitness",
        "workout"
      ],
      "mentionsToTrack": [
        "mrbeast"
      ],
      "accountStatus": "active",
      "postsToTrack": 30,
      "paymentRules": [
        {
          "rule": "per_post_flat",
          "amountUsd": 150,
          "percent": null,
          "minViews": null,
          "maxViews": null
        }
      ]
    }
  ]
}'
{
  "ok": true
}

Data Structures

View all 13 data structuresCreators

Explore all data structures used in this API endpoint