Trybe

Trybe

This connector uses the Trybe Brand API (https://api.jointrybe.com/v1), the HTTP API Trybe offers brands to pull data about their UGC creators: the creator roster with sample obligations, creator performance (earnings, Trybe conversions and GMV, ad spend, purchases and ROAS on Meta, TikTok and AppLovin) and the content creators submit. Reviewing a submission (approve, reject, request a revision) is included but installed switched off.

Setup (about 2 minutes)

1. API access is a feature of the brand account; if every call answers 403 feature_not_enabled, ask your Trybe contact to enable the Brand API for your brand.
2. Create an API key for your brand in the Trybe brand portal (or ask your Trybe contact for one). It starts with tk_live_. Paste it into TRYBE_API_KEY.
3. Install and run trybe_list_creators to check the key.

The key is sent as Authorization: Bearer tk_live_... and sees only your brand.

Workflow

• Roster: trybe_list_creators (filter sample_obligation=overdue for creators who owe a video), then trybe_get_creator for one creator's programs and commission rules.
• Performance: trybe_get_creator_performance for a period (default the last 30 complete UTC days). Rank the roster with sort_by (earnings, spend, purchase_value...), restrict to one creator with creator_id, to one program with program_id, or to Meta/TikTok/AppLovin with platforms.
• Content: trybe_list_submissions (e.g. status=pending for the review queue, query to find videos that say a word), then trybe_get_submission for one item.
• Reviews (switched off): trybe_approve_submission, trybe_reject_submission, trybe_request_submission_revision (needs a comment). The creator is notified at once and approval affects what they earn, so an admin turns these on deliberately; before each call show the user the submission and the comment and wait for a yes.

Reading the numbers: money fields end in _cents and are USD cents (spend_cents 250000 = 2,500.00 USD). Dates are UTC calendar days YYYY-MM-DD; end_date cannot be in the future. Sorting by a metric or active_only=true caps the window at 90 days. roas is purchase value divided by spend, null without spend. A creator's samples block of zeros means no samples; null means it could not be read on that request, so retry rather than reading it as none.

Ids: creators creator_<uuid>, programs creator_program_<uuid>, submissions submission_<uuid>, products product_<uuid>, groups subgroup_<uuid>. Use them exactly as returned. A submission's trybe_id (last 8 characters) must appear on the destination URL and ad name of every ad built from it; that is how Trybe attributes ads and pays creators.

Pagination and limits: lists return data, has_more and next_cursor. Default 20 rows, at most 100 (limit); call again with after = next_cursor while has_more is true. The API reports its rate limit in RateLimit-* headers (300 requests per window); 429 rate_limit_exceeded means wait and retry. Download links in asset.url expire after about 20 minutes.

Errors: 401 invalid_api_key means a missing or wrong key. 403 feature_not_enabled means the Brand API is not enabled for your brand. 400 validation_error names the bad parameter (e.g. start_date after end_date). 404 on one id means it does not exist or belongs to another brand.