Skip to main content

Using the API and Webhooks

Pull information and integrate submissions into your own systems.

Updated this week

At a Glance

  • Read-only API: Available under Account > Developers.

  • Webhooks: Only supports SUBMISSION_COMPLETE events today.

  • Tokens: Never expire, but refresh every 6 months is recommended.

  • Studio ID: Required for many endpoints, found under Settings > Other.

This article is meant as a quick overview. Full technical documentation (with request/response examples) is available in our Postman collection.


Accessing the API

  • Navigate to Account > Developers in the Scale Dashboard.

  • Generate an API token. Tokens never expire, but we recommend refreshing them every six months.

  • Current scope: read-only (no create/update functionality).

Webhook Events

We currently support one webhook topic:

  • SUBMISSION_COMPLETE - triggers when a submission has been accepted and AI enhancement is finished.

When this event fires, we'll send a POST request to the URL you provided.

Studio ID

Many API endpoints require a Studio ID. You can find this under Settings > Other in the Scale Dashboard.

Did this answer your question?