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/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"/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.jsonSave the input fields as request.json before running a write request. Replace path placeholders with your own IDs.
/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.jsonSave the input fields as request.json before running a write request. Replace path placeholders with your own IDs.
/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.jsonSave the input fields as request.json before running a write request. Replace path placeholders with your own IDs.
/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"