Integrations (Zapier, Make & more)

Connect badges.ninja to the tools you already use — issue credentials automatically when something happens elsewhere, and react in real time when credentials are issued, delivered, revoked, or viewed. Any platform that speaks REST and webhooks works; Zapier and Make are the quickest.

What You Can Automate

Triggers (badges.ninja → your tools) — fire a workflow when:

• a credential is issued
• a credential is delivered (its email is sent)
• a credential is revoked
• a credential is viewed for the first time

Actions (your tools → badges.ninja):

• issue a credential — award a badge to a recipient

Prerequisites

1. Create an API key in the dashboard under API Keys. Use a read-write key for actions (issuing); a read-only key is fine for triggers only. See API Keys.
2. That's it — everything runs over the REST API and webhooks.

Zapier

Once the badges.ninja Zapier app is connected:

1. Connect your account — paste your API key when prompted.
2. Pick a trigger (e.g. Credential Issued) or the Issue Credential action.
3. Map fields and turn the Zap on.

Under the hood, triggers use Zapier's REST Hook model backed by the Webhooks API: Zapier subscribes via POST /webhooks and badges.ninja delivers events to it in real time, so there's no polling delay.

Make (Integromat) & Custom Platforms

No app required — wire it up directly:

1. Authenticate with the X-Api-Key header on every request.
2. Subscribe to events by registering your endpoint:

   curl -X POST https://api.badges.ninja/webhooks \
     -H "X-Api-Key: bws_your_api_key_here" \
     -H "Content-Type: application/json" \
     -d '{ "url": "https://hook.example.com/badges", "events": ["credential.issued"] }'

3. Receive signed deliveries at your endpoint. Verify the X-Bws-Signature header — see Webhooks.
4. Issue credentials by calling POST /awards — see Awards API.

Reference

• Webhooks API — events, payloads, signatures, retries
• Awards API — issuing credentials
• API Keys — keys and access scopes

The Zapier app source lives in the repository under integrations/zapier/ and can be pushed with the Zapier CLI.