Get an agency invite as the creator
What accepting an agency invite means for the creator: who the agency is, what it may do on the account, and the revenue-split agreement when the invite carries one. Nothing changes.
Questions? [email protected]
What accepting an agency invite means for the creator: who the agency is, what it may do on the account, and the revenue-split agreement when the invite carries one. Nothing changes.
Questions? [email protected]
/api/external/v1/agency-invites/{token}also served at /api/external/agency-invites/{token}NewWhat accepting an agency invite means for the creator: who the agency is, what it may do on the account, and the revenue-split agreement when the invite carries one. Nothing changes.
Call it with the creator's own key (the apiKey from create-account) to build your consent screen, then accept once the creator agrees.
Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.
| Name | Type | Required | Description |
|---|---|---|---|
token | string | Required | inviteToken from [POST /agency/invites](/developers/reference/create-agency-invite). |
| Name | Type | Description |
|---|---|---|
status | string | accepted when this creator already accepted this invite.One of: pending, accepted |
agency | object | The agency that sent the invite: id, username, name, image. |
message | string | null | The agency’s personal note, or null. |
expiresAt | string | When the invite stops working (72 hours after it was created). Format: date-time |
permissions | object | What the agency may do on the creator’s account once accepted. |
split | object | null | Null for an invite without a revenue split (every invite created through the API). Otherwise agencyPercent, creatorPercent and agreement (bodyMarkdown to show the creator, bodyHash to send back when accepting). |
{
"status": "pending",
"agency": {
"id": "cmh1agc0q0001ab7k2p9q4r8s",
"username": "northlight",
"name": "Northlight",
"image": null
},
"message": "Hi Valeria — excited to work with you!",
"expiresAt": "2026-11-23T18:00:00.000Z",
"permissions": {
"canEditProfile": true,
"canManageDrops": true,
"canManageVault": true,
"canViewStats": true
},
"split": null
}| Status | Body | When |
|---|---|---|
| 400 | {"error":"This endpoint only acts as the key’s own account — send it without X-Dropfans-Account.","code":"account_header_not_allowed"} | The request named another account (`X-Dropfans-Account`, or `/v1/creators/{creatorId}/…` → `creator_scope_not_allowed`). The creator consents with their own key. |
| 400 | {"error":"Cannot accept your own invite","code":"own_invite"} | The key belongs to the agency that sent the invite. |
| 401 | {"error":"Unauthorized","code":"unauthorized"} | Missing or invalid API key. |
| 403 | {"error":"This endpoint needs the creator’s own API key, not a key an agency created for them.","code":"creator_key_required"} | The key was created by an agency for the creator. Use the key from create-account, or one the creator made themselves. |
| 403 | {"error":"This account cannot be managed by an agency: it is an agency account itself.","code":"not_eligible"} | The account is an agency (signed up with `accountType: "agency"`), not a creator. |
| 403 | {"error":"This agency can no longer take on creators.","code":"agency_unavailable"} | The agency is no longer verified, or is suspended. |
| 404 | {"error":"Invalid invite link","code":"invite_not_found"} | No invite has this token. |
| 410 | {"error":"Invite has been revoked","code":"invite_revoked"} | The agency revoked the invite. |
| 410 | {"error":"Invite already used","code":"invite_used"} | Another creator accepted this invite. Create a new one. |
| 410 | {"error":"This invite was declined. Ask the agency for a new one.","code":"invite_declined"} | A creator declined this invite. Create a new one. |
| 410 | {"error":"Invite expired","code":"invite_expired"} | The invite is older than 72 hours. Create a new one. |
| 400 | {"error":"This endpoint acts as the key’s own account or app — call it without /creators/{creatorId}.","code":"creator_scope_not_allowed"} | Called under /api/external/v1/creators/{creatorId}/ — this endpoint always acts as the key’s own account, agency or app. |
Every response carries the X-RateLimit-Tier header and, on limited tiers, the per-minute and per-day trios — read X-RateLimit-Remaining and X-RateLimit-Reset instead of hardcoding limits. Details in Rate limits.
curl "https://www.dropfans.io/api/external/v1/agency-invites/$TOKEN" \
-H "Authorization: Bearer $DROPFANS_API_KEY"const token = '…'; // from an earlier response
const res = await fetch(`https://www.dropfans.io/api/external/v1/agency-invites/${token}`, {
headers: {
Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
},
});
console.log(await res.json());import os
import requests
token = "…" # from an earlier response
res = requests.get(
f"https://www.dropfans.io/api/external/v1/agency-invites/{token}",
headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
)
print(res.json())