Skip to main content

Using the Developer Console: API Keys and Webhooks

How to create and manage API keys and webhooks in the MasterID Developer Console for integrating identity verification into your own systems.

Written by Patrick Muwanguzi

The Developer Console is available on Advanced accounts. It lets you integrate MasterID's verification capabilities directly into your own applications using API keys and webhooks.

Accessing the Developer Console

Go to More in the bottom navigation bar, then tap Developer Console. At the top, you'll see a request summary showing:

  • All Requests — total API calls made

  • Successful — requests that completed successfully (shown as a percentage)

  • Failed — requests that returned an error (shown as a percentage)

Your UUID

Below the summary, you'll see your account UUID. This is your unique identifier used when making API calls. Keep it secure.

API Keys

API keys allow your application to authenticate with MasterID's API. Each key has:

  • API Name — a label you give the key (e.g. "MasterID Core API", "Verification API")

  • API Key — the actual key value (partially masked for security, e.g. MIL-123****)

  • Creation Date

  • Environment — either Production (live, real verifications) or Sandbox (for testing)

  • Last Usage date

To create a new API key, tap + Create API and follow the prompts. Use Sandbox keys for development and testing. Switch to a Production key only when you're ready to go live. Never expose your API keys in client-side code or public repositories.

Webhooks

Webhooks allow MasterID to send real-time notifications to your system when events occur (such as a verification completing). Each webhook has:

  • Name — a label for the webhook (e.g. "KYC Completed", "Verification Status")

  • URL — the endpoint on your server that receives the notification

  • API — which API key the webhook is associated with

  • Permission — Full Permission or Read Permission

Your Webhook Secret is shown in the Developer Console. Use it to verify that incoming webhook requests genuinely originate from MasterID. Tap + Add Webhook to create a new endpoint.

Environments

  • Production (green) — live environment. Verifications are real, charged against your wallet.

  • Sandbox (orange) — test environment. Use this to develop and test your integration without incurring charges.

The Developer Console is only available on Advanced accounts. If you're on Express and need API access, switch to Advanced in Account Settings.

Related Articles
Did this answer your question?