TLNT Connect API
Operate an agency workspace from your own agent over REST. Every call acts as the team member who created the key, within the scopes it holds. Pro plan and above.
https://dev.tlntconnect.com/api/v1Quick start
REST
- A workspace admin creates a key in Settings → Integrations → API keys and picks its permissions.
- Send it as a Bearer token:
curl https://dev.tlntconnect.com/api/v1/me -H "Authorization: Bearer $TLNT_API_KEY"Scopes
A key only reaches what its scopes allow, and never more than the member it acts as can do in the app. New keys start with the default read scopes. High-risk scopes are never pre-selected.
workspace:readTeam, entitlements, notifications and workspace searchroster:readRoster creators, handles, reach and statusroster:writeCreate and edit roster creators, notes and tags, and reassign creators to managers (up to the daily reassignment cap)lists:readCreator lists and their memberslists:writeCreate lists, add and remove memberscampaigns:readCampaigns, deal stages, attached creators and deliverablescampaigns:writeCreate and edit deals, attach roster creatorsbrands:readBrands, contacts and segmentsbrands:writeCreate and edit brands and contactstasks:readTasks, calendar holds, files and saved viewstasks:writeCreate and edit tasks, holds, files and viewscasting:readCasting calls and submissionscasting:writeDraft casting calls and review submissions (publishing needs share:public)discovery:readSaved searches, runs, reports and credit balanceinbox:readMailboxes, threads, message bodies and attachments (personal data)inbox:writeUpdate threads and draft replies (sending needs email:send)outreach:readTemplates, send history and statsoutreach:writeEdit templates and preview sends (sending needs email:send)messages:readCreator portal messages (creator-written text is returned as untrusted content)finance:readCampaign deal values, agency fees and creator rates, the creator rate suggestion, list quoted rates, invoices and payouts (admin members only)invoices:writeCreate and edit invoice drafts and their line items (sending needs email:send and the user's written confirmation in chat; admin members only)atlas:readAtlas operational findings (read-only)email:sendSend outreach, inbox replies and invoice emails (invoices after written confirmation in chat)messages:sendMessage creators through their portal (after written confirmation in chat; each counts as one email recipient)share:publicPublic links to lists, media kits and campaign reports, the roster join link, and publishing casting calls (up to the daily public link cap)discovery:spendRun paid searches, reports and email unlocksdeleteDelete records in any granted areacontracts:writeContract templates and agreement signature requests (after written confirmation in chat; admin members only)Never available over the API: team role changes and member removal; invitations; API key and connector management; integration connects; billing and subscription; workspace settings; approving or rejecting Atlas actions; moving money (payouts, direct pay, refunds).
Sensitive actions
A key with the scope runs the call, within the daily cap of its class below; without the scope it is 403. There is no approval step in TLNT. A retry with the same Idempotency-Key never runs twice: once the 24-hour replay window has passed it answers 200 status: "already_decided" (or 202 pending_approval while the action is still running) with the action_id; read it with get_action (GET /api/v1/actions/{action_id}).
email:send.share:public.delete.discovery:spend.roster:write.inbox:write.messages:send.contracts:write.- Past a daily cap the call answers
429and nothing runs. A workspace admin can change the caps per key in Settings. - Written confirmation in chat:
send_invoice,request_agreement_signature,send_creator_message. The first call sends nothing and answers200withstatus: "confirmation_required", the exact preview and aconfirmation_token. Show the preview to the user; only after they confirm it in writing, call again with the same arguments and the token (single use, 10 minutes). It then sends once.
Costs
- Paid Discovery calls spend Discovery credits at the app's rate card. Call the free preflight first; it returns the price and a
quote_token(5 minutes) for the paid call. An empty creator report is charged like the app. - Inbox summaries and drafts use one Atlas credit each, from the workspace's monthly Atlas allowance.
- Free: Competitor tracked, Creative direction, Outreach email (no credits; the daily recipient cap still applies).
generate_creator_scriptScript regeneration: 1 credit — quote with preflight_creator_scriptpurchase_creator_reportCreator report: 15 credits — quote with preflight_creator_reportrun_discovery_searchCreator search · 15 results: 3 credits · AI search · 15 results: 6 credits · Lookalike search · 15 results: 6 credits — quote with preflight_discovery_searchunlock_creator_contactsContact unlock: 1 credit (provisional) — quote with preflight_contact_unlockget_audience_overlapAudience overlap: 15 credits (provisional) — quote with preflight_audience_overlapget_creator_collaborationsCollaboration lookup: 3 credits (provisional) — quote with preflight_creator_collaborationsErrors
{ "error": { "code": "missing_scope", "message": "…", "issues": [ … ], "retry_after_seconds": 30 } }codeis stable;messageis for people.issueslists invalid input fields (400).Retry-Aftercomes with 429 rate limits and daily caps, 409 in-progress retries, 503, and every 202.- Writes accept an
Idempotency-Keyheader; the same key and request within 24 hours replays the stored response withIdempotent-Replayed: true.
invalid_inputinvalid_jsoninvalid_ididempotency_key_requiredmissing_tokeninvalid_tokenrevoked_tokenexpired_tokentrial_limit_reachedinsufficient_creditsplan_selection_requiredlive_campaign_limit_exceededresource_limit_exceededusage_limit_exceededmissing_scopecredit_limit_reachedactor_unavailablerole_forbiddenplan_upgrade_requiredfeature_not_availableactor_forbiddenactor_inactive_or_changedcampaign_creator_scope_forbiddenmailbox_permission_requiredatlas_disablednot_foundbrand_not_foundmanager_not_foundcampaign_not_foundcreator_not_foundassignee_not_foundmethod_not_allowedconflictduplicateduplicate_creatorstale_targetidempotency_key_reusedidempotency_in_progressidempotency_context_changedidempotency_response_too_largeoperation_in_progressoperation_already_chargedupload_incompletequote_expiredquote_invalidquote_staleconfirmation_invalidconfirmation_expiredconfirmation_staleconfirmation_usedexpected_updated_at_requiredrate_limiteddaily_send_cap_reacheddaily_credit_cap_reacheddaily_delete_cap_reacheddaily_public_link_cap_reacheddaily_reassignment_cap_reachedatlas_run_throttledinternal_erroridempotent_replay_of_failureservice_unavailableReference
161 operations, generated from /api/v1/openapi.json (OpenAPI 3.1). Open an operation for its inputs, responses and rules.
Workspace
Team
Campaigns
- GET
/api/v1/campaigns - POST
/api/v1/campaigns - GET
/api/v1/campaigns/{campaign_id} - PATCH
/api/v1/campaigns/{campaign_id} - DELETE
/api/v1/campaigns/{campaign_id} - POST
/api/v1/campaigns/{campaign_id}/creators - POST
/api/v1/campaigns/{campaign_id}/duplicate - POST
/api/v1/campaigns/import - GET
/api/v1/campaigns/{campaign_id}/report - PATCH
/api/v1/campaigns/{campaign_id}/creators/{creator_id} - DELETE
/api/v1/campaigns/{campaign_id}/creators/{creator_id} - GET
/api/v1/campaigns/{campaign_id}/creators/{creator_id}/rate-suggestion - GET
/api/v1/campaigns/{campaign_id}/collaborators - POST
/api/v1/campaigns/{campaign_id}/collaborators - DELETE
/api/v1/campaigns/{campaign_id}/collaborators/{member_id} - GET
/api/v1/deal-categories - POST
/api/v1/deal-categories - GET
/api/v1/campaigns/{campaign_id}/tracked-posts - POST
/api/v1/campaigns/{campaign_id}/tracked-posts - PATCH
/api/v1/campaigns/{campaign_id}/tracked-posts/{tracked_post_id} - DELETE
/api/v1/campaigns/{campaign_id}/tracked-posts/{tracked_post_id} - GET
/api/v1/campaigns/{campaign_id}/tracking-keywords - POST
/api/v1/campaigns/{campaign_id}/tracking-keywords - DELETE
/api/v1/campaigns/{campaign_id}/tracking-keywords/{keyword_id} - GET
/api/v1/campaigns/{campaign_id}/email-threads - POST
/api/v1/campaigns/{campaign_id}/email-threads - DELETE
/api/v1/campaigns/{campaign_id}/email-threads/{link_id} - GET
/api/v1/campaigns/{campaign_id}/creators/{creator_id}/script - POST
/api/v1/campaigns/{campaign_id}/creators/{creator_id}/script - POST
/api/v1/campaigns/{campaign_id}/creators/{creator_id}/script/preflight
Deliverables
- GET
/api/v1/campaigns/{campaign_id}/deliverables - POST
/api/v1/campaigns/{campaign_id}/deliverables - PATCH
/api/v1/campaigns/{campaign_id}/deliverables/{deliverable_id} - POST
/api/v1/campaigns/{campaign_id}/deliverables/{deliverable_id}/review - GET
/api/v1/campaigns/{campaign_id}/deliverables/{deliverable_id}/submissions - GET
/api/v1/campaigns/{campaign_id}/deliverables/{deliverable_id}/draft-url - POST
/api/v1/campaigns/{campaign_id}/deliverables/{deliverable_id}/draft-upload-url - GET
/api/v1/deliverable-types - POST
/api/v1/deliverable-types - PATCH
/api/v1/deliverable-types/{deliverable_type_id}
Roster
Lists
- GET
/api/v1/lists - POST
/api/v1/lists - GET
/api/v1/lists/{list_id} - PATCH
/api/v1/lists/{list_id} - DELETE
/api/v1/lists/{list_id} - GET
/api/v1/lists/{list_id}/members - PATCH
/api/v1/lists/{list_id}/members - PATCH
/api/v1/lists/{list_id}/order - POST
/api/v1/lists/{list_id}/duplicate - PATCH
/api/v1/lists/{list_id}/members/{creator_id}
Brands
Tasks
Calendar
Files
Discovery
- GET
/api/v1/discovery/runs - GET
/api/v1/discovery/runs/{run_id} - GET
/api/v1/discovery/runs/{run_id}/results - GET
/api/v1/discovery/runs/{run_id}/diagnostics - POST
/api/v1/discovery/runs/{run_id}/cancel - POST
/api/v1/discovery/runs/{run_id}/results/import - POST
/api/v1/discovery/runs/{run_id}/results/add-to-list - GET
/api/v1/discovery/runs/{run_id}/results/{result_id}/report - POST
/api/v1/discovery/runs/{run_id}/results/{result_id}/report - GET
/api/v1/discovery/credits - GET
/api/v1/discovery/credits/history - GET
/api/v1/discovery/presets - GET
/api/v1/discovery/presets/{preset_id} - POST
/api/v1/discovery/presets/{preset_id}/unschedule - POST
/api/v1/discovery/searches/preflight - POST
/api/v1/discovery/searches - POST
/api/v1/discovery/runs/{run_id}/results/{result_id}/report/preflight - POST
/api/v1/discovery/contact-unlock/preflight - POST
/api/v1/discovery/contact-unlock - POST
/api/v1/discovery/audience-overlap/preflight - POST
/api/v1/discovery/audience-overlap - POST
/api/v1/discovery/collaborations/preflight - POST
/api/v1/discovery/collaborations - POST
/api/v1/discovery/presets/{preset_id}/schedule - GET
/api/v1/discovery/spend-results/{action_id}
Inbox
- GET
/api/v1/inbox/mailboxes - GET
/api/v1/inbox/threads - GET
/api/v1/inbox/threads/{thread_id} - PATCH
/api/v1/inbox/threads/{thread_id} - GET
/api/v1/inbox/threads/{thread_id}/attachments/{attachment_id} - POST
/api/v1/inbox/threads/{thread_id}/summary - POST
/api/v1/inbox/threads/{thread_id}/draft-reply - POST
/api/v1/inbox/threads/{thread_id}/reply
Invoices
- GET
/api/v1/invoices - POST
/api/v1/invoices - GET
/api/v1/invoices/{invoice_id} - PATCH
/api/v1/invoices/{invoice_id} - DELETE
/api/v1/invoices/{invoice_id} - POST
/api/v1/invoices/{invoice_id}/line-items - PATCH
/api/v1/invoices/{invoice_id}/line-items/{line_item_id} - DELETE
/api/v1/invoices/{invoice_id}/line-items/{line_item_id} - POST
/api/v1/invoices/{invoice_id}/send
Payouts
Contracts
Casting
- POST
/api/v1/casting-calls/{casting_call_id}/publish - DELETE
/api/v1/casting-calls/{casting_call_id}/publish - GET
/api/v1/casting-calls - POST
/api/v1/casting-calls - GET
/api/v1/casting-calls/{casting_call_id} - PATCH
/api/v1/casting-calls/{casting_call_id} - DELETE
/api/v1/casting-calls/{casting_call_id} - GET
/api/v1/casting-calls/{casting_call_id}/submissions - PATCH
/api/v1/casting-calls/{casting_call_id}/submissions/{submission_id}
Messages
Outreach
- GET
/api/v1/outreach/templates - POST
/api/v1/outreach/templates - GET
/api/v1/outreach/templates/{template_id} - PATCH
/api/v1/outreach/templates/{template_id} - DELETE
/api/v1/outreach/templates/{template_id} - POST
/api/v1/outreach/preview - POST
/api/v1/outreach/send - GET
/api/v1/outreach/history - GET
/api/v1/outreach/history/{log_id} - GET
/api/v1/outreach/stats
