API keys

Read only and Read & write keys, and keeping them safe.

Each key belongs to one business and only ever sees that business's data. Keys are made in Settings › API keys by the business owner.

Two kinds of key

KeyWhat it can do
Read onlyRead campaigns, participants, analytics and reviews.
Read & writeAll of that, plus approve and reject videos.

Calling approve or reject with a Read only key answers 403.

What approving does

Approving through the API does exactly what Approve does in Videos to review. What the creator earned comes out of the campaign's money and lands in their wallet, ready for them to withdraw. Rejecting tells the creator why.

Neither can be undone from the API, so only use a Read & write key where you need one.

There's no test mode. Every key works on your real campaigns, so only approve or reject a video you really mean to.

Keeping keys safe

  • Keep keys on your server, in an environment variable or secrets manager.
  • Never put a key in a web page, a mobile app or a public code repository.
  • A key is shown once. If you lose it, delete it and make another.
  • If a key leaks, delete it in Settings › API keys. It stops working straight away.

Need help? Email support@loopearn.com