Skip to content

How to generate an AvenPing API token

An API token authenticates AvenPing API v2. Settings → API Settings and Settings → Webhook Settings require Premium or Enterprise. Click Generate Token, copy API Access Token, then call GET /v2/me.

Prerequisites

Step-by-step

  1. Open API Settings
    Sign in at app.avenping.com. Go to Settings. Under DEVELOPER, click API Settings. If you see Premium or Enterprise plan required, click Explore plans.

  2. Generate Token
    If the page shows No API token found, click Generate Token and confirm the warning. Success toasts API token generated successfully. The token displays briefly (Show / Hide, Copy). Status shows Token Active.

  3. Copy Base URL
    Under API Configuration, copy Base URL https://api.avenping.com. Send the token as Authorization: Bearer YOUR_TOKEN or X-API-Token: YOUR_TOKEN on every protected request.

  4. Call GET /v2/me
    Request GET https://api.avenping.com/v2/me with the token. Copy a phoneNumberId from phoneNumbers, or use defaultPhoneNumberId. Field-level response shape is in Account (GET /v2/me).

  5. Regenerate only when needed
    Click Regenerate to rotate. The previous token stops working immediately. Store the new value in a secret manager, never in frontend code.

WARNING

Other plans cannot generate tokens. Regenerating invalidates the old token at once.

FAQ

Why do I see a lock instead of API Settings content?

Webhook Settings and API Settings are gated to Premium or Enterprise. Upgrade under Settings → Subscription.

Bearer or X-API-Token?

Either header works with the same token value. See Authentication.

What should I call first after generating a token?

GET /v2/me, then a send route such as POST /v2/messages. See How to send a WhatsApp text message via API v2.