API referenceIntegrations

Import Trybe submissions

Copies up to 50 approved Trybe submissions into the brand's "Trybe" creative folder. The request is refused as a whole when it lists more than 50 ids, the same id twice, or an id that is not a Trybe submission id. Each id is then answered on its own: imported (with its creativeId, also for one imported before), skipped (unknown to the brand's Trybe account, not approved, or with no file) or failed (the file could not be copied; retrying may work), with the reason. Fails with a message naming Settings → Integrations → Trybe when Trybe is not connected or no longer accepts the brand's key.

POST
/v1/brands/{brandId}/integrations/trybe/submissions/import
bearerAuth
headerAuthorizationBearer <token>

An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.

brandId*integer

The brand the request acts on. Every brand-scoped resource lives under its brand.

Idempotency-Key?string

Retrying with the same key within 24 hours returns the first response without acting again.

Lengthlength <= 255
application/json
  1. body
submissionIds*array<>

The Trybe submissions to import, 1 to 50 distinct ids from list-trybe-submissions.

Items1 <= items <= 50

Response Body

Import Trybe submissions

application/json
  1. response
imported*array<>

Submissions now in the library, including ones that were already there.

skipped*array<>

Submissions refused: unknown to this brand's Trybe, not approved, or with no file.

failed*array<>

Submissions whose file could not be copied; importing them again may work.

curl -X POST "https://example.com/v1/brands/0/integrations/trybe/submissions/import" \  -H "Authorization: Bearer koast_sk_..." \  -H "Content-Type: application/json" \  -d '{    "submissionIds": [      "string"    ]  }'
{  "imported": [    {      "submissionId": "string",      "creativeId": -9007199254740991    }  ],  "skipped": [    {      "submissionId": "string",      "reason": "string"    }  ],  "failed": [    {      "submissionId": "string",      "reason": "string"    }  ]}

Required scope: write. CLI: koast import-trybe-submissions, see Integrations commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.