Use the PlayerMagick API with an API key

Updated Oct 26, 2026 · 4 min read · Pro, Business and Agency plans

This article shows you how to create an API key, what a key can and can't do, and how your own scripts, Zapier or Make can read your videos, analytics and sales.

Available on: Pro, Business and Agency plans.

Before you start

  • Only the account owner or an admin can create and revoke keys. See Understand team roles.
  • A key works in one account. If you run an agency, create one key in each client account that needs one.
  • A key works as you, only within the permissions you give it. If you leave the team, or you are no longer an owner or admin, your keys stop working.

Step 1: Create a key

  1. Go to Settings → API and MCP.
  2. Under API keys, click Create key.
  3. Give the key a Name you will recognise later, like Weekly report script or Zapier.
  4. Tick only what the key needs:
    • See: videos and folders, analytics and A/B results, funnels and their statistics, sales.
    • Change: video titles, thumbnails, start, button text and time; folders (create, rename, move videos); start and end A/B tests.
    • Personal data: leads (names and emails). Tick this only if the key really needs it.
  5. Choose when it Expires: in 1 year (the default), 90 days or 30 days.
  6. Click Create key.
  7. Copy the key now and keep it somewhere safe, like a password manager. This is the only time PlayerMagick shows it.

Keys start with pmk_. If a key ever ends up somewhere public, revoke it at once (Step 3) and create a new one.

Step 2: Use the key

Send the key with every request, in the Authorization header:

Authorization: Bearer pmk_your_key

The address of the API is https://api.playermagick.com/v1. For example, GET https://api.playermagick.com/v1/videos lists your videos.

The full list of what you can ask for is in the API reference: https://api.playermagick.com/v1/openapi.json. Tools like Postman, Zapier's API request step or Make's HTTP module can read it.

What the API does:

  • Read your videos (status, settings in plain words, embed code), folders, analytics, A/B test results, funnels, sales confirmed by your sales platforms and, with permission, your leads.
  • Change a short list of safe things: a video's title, folder, thumbnail, how it starts, its start volume, and a text button's text and time; folders; A/B tests.

What it never does:

  • Change button or page links.
  • Delete anything, upload files or import videos.
  • Send emails, webhooks or automations.

Step 3: Revoke a key

  1. Go to Settings → API and MCP.
  2. Find the key under API keys and click Revoke.
  3. Confirm. Anything using the key stops working at once.

A key that expires within 14 days shows its date in amber. Create a new key before it expires and switch your script over.

Limits

Each key can make 120 reads, 30 changes and 30 analytics requests a minute, and an account 300 requests a minute in total. Over a limit, the API answers 429 and tells your script how many seconds to wait.

If a key or a connected app makes more than 50 changes in an hour, the account's owner and admins get an email, so an unexpected script never goes unnoticed.

Troubleshooting

  • 401 invalid_key: the key is mistyped, revoked or expired, or the person who made it left the team or is no longer an owner or admin. Create a new key.
  • 403 insufficient_scope: the key doesn't have the permission this request needs. Create a key with it.
  • 403 plan_feature: the API comes with Pro, Business and Agency.
  • 409 version_conflict: the video changed since your script read it. Read the video again and send its new settings_version.

Was this article helpful?