Vaaniq
Integrations & API

How to Create an API Key

Generate a scoped API key to authenticate requests from your own systems into Vaaniq's Messaging API.

Intermediate 3 min read

Tutorial video coming soon

What You'll Learn

In this tutorial you'll learn:

  • Create an API key with the scopes it needs
  • Authenticate a request with it

Step-by-Step Guide

1

Create a key

Dashboard → Settings → Developer → API Keys → Create API Key

Give it a descriptive name, e.g. "CRM Integration", and choose which scopes it needs, such as template:send.

Developer page API Keys tab with the New API Key button highlighted
Settings → Developer → API Keys.
Create API Key dialog with name, description, expiration, rate limit and the template:send permission selected
Name the key and select only the permissions it needs.
2

Copy it immediately

The full key is only ever shown once, right after creation — copy and store it securely before closing the dialog.

API key created dialog warning that the full key is shown only once, with a Copy button; the key itself is blurred
Copy the key now. It isn't shown again. (Key blurred in this screenshot.)
3

Use it in requests

Send it in an X-API-Key header on every request, not as a Bearer token.

Tip

An API key's permissions come entirely from the scopes you assign it, not from your own user role — pick only the scopes it actually needs.

Tip

Delete a key immediately if it's ever exposed or no longer needed — this revokes access right away.

Integrations & API

How to Send WhatsApp Messages Using the API

Trigger an approved WhatsApp template from your own website, CRM, or automation tool with a single API call.

Advanced 5 min read
Read Tutorial
Integrations & API

How to Receive WhatsApp Events Using Webhooks

Register your own endpoint to receive real-time, signed events whenever a message is sent, delivered, read, or a campaign finishes.

Advanced 5 min read
Read Tutorial
WhatsApp Templates

Understanding Marketing, Utility & Authentication Templates

The three WhatsApp template categories, what each is for, and how they're priced and rate-limited differently.

Beginner 3 min read
Read Tutorial
Automation & Chatbots

How to Connect APIs with Chatbot Flows

Call an external API from inside a chatbot flow and use its response to drive the conversation.

Advanced 6 min read
Read Tutorial
How to Create an API Key — Vaaniq Tutorials