Creators · Creator Campaigns
Creates a campaign invite link.
POST
https://api.pozy.ai/v1/creator-campaigns/{campaignId}/invite-linkcreateCampaignInviteLink
Guide: Run a campaign
Request
Send your API key as Authorization: Bearer pz_live_.... Read-only keys cannot call it. Keys with the creator_campaigns resource group disabled get 403 resource_group_disabled. Authentication
Path parameters
| Name | Type | Notes |
|---|---|---|
campaignIdrequired | string |
Example
curl -X POST "https://api.pozy.ai/v1/creator-campaigns/65a3737dd8b11ea61f199e6e/invite-link" \
-H "Authorization: Bearer $POZY_API_KEY"const res = await fetch("https://api.pozy.ai/v1/creator-campaigns/65a3737dd8b11ea61f199e6e/invite-link", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);import os
import requests
resp = requests.post(
"https://api.pozy.ai/v1/creator-campaigns/65a3737dd8b11ea61f199e6e/invite-link",
headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
timeout=30,
)
resp.raise_for_status()
print(resp.json())Response
201 on success
inviteUrlstring (URL)required
201 response
{
"inviteUrl": "https://pozy.ai/media/example-1.jpg"
}Errors
Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:
| 400 | invalid_request_error | A parameter or body field is missing or invalid. param names it. |
| 401 | authentication_error | The API key is missing, revoked or expired. |
| 403 | permission_error | The key is read-only, scoped to other profiles, or has this resource group disabled. |
| 404 | not_found | Nothing with that id exists in your workspace. |
| 429 | rate_limit_error | Too many requests this minute. Wait for Retry-After seconds. |
Every code is listed in Errors.
More in Creator Campaigns
GETList creator campaignsPOSTCreate creator campaignGETGet creator campaignPATCHUpdate creator campaignPOSTRaise creator campaign budgetPOSTActivate creator campaignPOSTPause creator campaignPOSTClose creator campaignGETList campaign participantsPOSTInvite campaign participantGETGet campaign participantPOSTSuspend campaign participantPOSTReinstate campaign participantPOSTRemove campaign participantPOSTResend campaign participant invitePOSTSettle campaign participantGETList payout batchesPOSTPay creators with one card paymentGETList campaign submissionsGETGet campaign submissionPOSTApprove campaign submissionPOSTReject campaign submissionPOSTReopen campaign submissionGETList campaign payablesPOSTCreate campaign adjustmentGETList campaign ledgerGETGet campaign report