Skip to Content
APIAuthentication

Authentication

Workspace / admin: API keys

API keys are for a single workspace and can be created by the owner or admin. They provide access to workspace and admin-style routes (markups, webhooks, workspaces, users, etc.). More granular permissions may be introduced in the future.

API keys must be kept secret, stored securely, and used only for server-to-server communication. Treat them like passwords.

Creating an API key

API keys can only be created through the MarkUp web application. Workspace owners and admins can create API keys by following these steps:

  1. Log in to MarkUp.io 
  2. Navigate to your workspace settings
  3. Go to the Developer Settings section
  4. Follow the onboarding wizard to create your API key

The wizard will guide you through configuring scopes and permissions for your API key.

Pass the API key as a Bearer token in the Authorization header.

Curl - Example request with API key secret
curl https://api.markup.io/api/v2/webhook-registrations \
    -X GET \
    -H "Authorization: Bearer <API-KEY-SECRET>" \
    -H "Content-Type: application/json" \
    -H "Markup-API-Version: 2023-02-22"
APIVersioning