AutoClip

REST API · v1

Campaign submissions

A submission is one posted clip sent to one Content Rewards campaign. Auto-Earn creates and submits these for you; these routes are for reviewing them and for manual work.

https://polished-turtle-977.convex.siteGet an API key
GET

/api/v1/campaign-submissions

Submission history, with the Content Rewards status when it has synced.

Input
?status=ready|submitted|pending|approved|rejected|failed|refused|expired|all &clipId= &campaignId= &limit= &cursor=
Response shape
{ data: [{ id, clipId, campaignId, status, crStatus, crSyncedAt, submissionUrl, … }], nextCursor }
curl --request GET 'https://polished-turtle-977.convex.site/api/v1/campaign-submissions' \
  --header "Authorization: Bearer $AUTOCLIP_API_KEY"
POST

/api/v1/campaign-submissions

Queue a clip for a campaign.

Input
{ clipId, campaignId, postUrl? }
Response shape
201 Submission
curl --request POST 'https://polished-turtle-977.convex.site/api/v1/campaign-submissions' \
  --header "Authorization: Bearer $AUTOCLIP_API_KEY" \
  --header "Content-Type: application/json" \
  --data @request.json

Save the input fields as request.json before running a write request. Replace path placeholders with your own IDs.

PATCH

/api/v1/campaign-submissions/{id}

Mark as submitted after you submitted it on Content Rewards yourself ({ status: "submitted" }), or correct a record. Records synced from Content Rewards cannot be corrected (409 conflict).

Input
{ status: "submitted", externalSubmissionId? } or { status: "pending"|"approved"|"rejected", estimatedViews? }
Response shape
Submission
curl --request PATCH 'https://polished-turtle-977.convex.site/api/v1/campaign-submissions/{id}' \
  --header "Authorization: Bearer $AUTOCLIP_API_KEY" \
  --header "Content-Type: application/json" \
  --data @request.json

Save the input fields as request.json before running a write request. Replace path placeholders with your own IDs.

POST

/api/v1/campaign-submissions/{id}/retry

Retry a failed automatic submission.

Response shape
{ reset }
curl --request POST 'https://polished-turtle-977.convex.site/api/v1/campaign-submissions/{id}/retry' \
  --header "Authorization: Bearer $AUTOCLIP_API_KEY" \
  --header "Content-Type: application/json" \
  --data @request.json

Save the input fields as request.json before running a write request. Replace path placeholders with your own IDs.

GET

/api/v1/campaign-submissions/clip-posts

Where a clip was posted, and whether each post is still inside the 30-minute submit window.

Input
?clipId=
Response shape
{ data: [{ platform, postUrl, postedAt, withinSubmitWindow }] }
curl --request GET 'https://polished-turtle-977.convex.site/api/v1/campaign-submissions/clip-posts' \
  --header "Authorization: Bearer $AUTOCLIP_API_KEY"