# Creators

Turning your users into tracked creators, one or a roster at a time.

## Enrolling a creator

A creator is one of your own users who has been given a tracked link. You identify them by your id for them, not ours: pass externalId and we key everything to it.

```bash
curl -X POST https://track.acrune.com/v1/creators \
  -H "Authorization: Bearer $ACRUNE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "campaignExternalId": "cmp_4471",
       "externalId": "sa_8842",
       "handle": "apexlaps",
       "platform": "tiktok"
     }'
```

Name the campaign with campaignId or campaignExternalId. It may be omitted only when the account has exactly one campaign; any account running a marketplace has more than one, so name it.

## Calling it twice

Idempotent on externalId. Calling it again for the same person returns the same link with 200 rather than issuing a second one, so it is safe on every render of your creator dashboard and you do not need to store the link or guard the call. Storing it is still faster.

> One enrolment is one link, keyed on externalId alone. If a creator's TikTok and Instagram should be counted separately, enrol them twice with a per-social-account id, their user id will not do it, because the second call finds the first creator and hands back the first link.

A handle that has changed is refreshed on the next enrolment, keeping the same link. The platform is not: changing it would rewrite the meaning of clicks already recorded against that creator.

## A roster in one call

A campaign launch is one brief and several hundred creators at once. Enrol them in one call rather than several hundred.

```bash
curl -X POST https://track.acrune.com/v1/creators/bulk \
  -H "Authorization: Bearer $ACRUNE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "campaignExternalId": "cmp_4471",
       "creators": [
         { "externalId": "sa_8842", "handle": "apexlaps", "platform": "tiktok" },
         { "externalId": "sa_8843", "handle": "mia.clips", "platform": "instagram" }
       ]
     }'
```

Up to 200 at a time. Partial success is reported rather than rolled back: one creator whose handle is already held by a different user of yours must not cost the other 199 their links, so read refused and act on it.

## Reading one back

What one of your users has to show for it, across every campaign they are on. This is the read behind a number in your own creator UI.

```bash
curl "https://track.acrune.com/v1/creators/sa_8842?since=2026-08-01T00:00:00Z" \
  -H "Authorization: Bearer $ACRUNE_KEY"
```
