Skip to main content

General information about edna Pulse API keys and webhooks

Last updated: 27 August 2026

API keys​

An API key is a method of authentication when working with the edna Pulse API. It determines access to API data and methods.

tip

edna Pulse uses two types of API keys: master and additional.

File IconHow to choose the right API key and webhook type File IconManaging API keys for integration with the edna Pulse API

Master API key​

  • Generated manually in the Integration → Settings → Main profile tab in your edna Pulse account.
  • Provides access to all account data and all edna Pulse API methods.
  • Only one key can exist per account.
  • It cannot be deleted, but a new one can be generated.
  • You cannot set an expiration date for the key.

Additional API keys​

  • Generated manually in the Integration → Settings → API Key tab of your edna Pulse account.
  • You can grant access to all or only selected channels and groups of edna Pulse API methods.
  • Multiple keys can be created within a single account.
  • You can set the key’s expiration date and delete it.
  • You can use either one API key per channel or a single API key for multiple channels.
  • Key restrictions apply to all requests made using it.
  • A single channel can be linked to only one additional API key.
  • Only one additional API key can be used for a single channel in conjunction with the master API key.

Webhooks​

A webhook is an event notification that edna Pulse sends to a URL in another system in real time.

tip

edna Pulse uses two types of webhooks: master and additional.

File IconHow to choose the right API key and webhook type File IconManaging edna Pulse webhooks

Event types for webhooks​

Webhooks are configured based on event types. Supported event types for channels:

  • Change of message statuses — for WhatsApp and Viber channels.
  • Template registration status updates — for WhatsApp and Viber channels.
  • Incoming messages — for WhatsApp and Viber channels.
  • WhatsApp template category changes — only for WhatsApp channels.
  • Tracking clicks on the WhatsApp link button — only for WhatsApp channels.
  • Sender status changes — for WhatsApp and Viber channels.

Configure webhook delivery based on your system’s requirements:

  • one URL — for all event types;
  • different URLs — for different event types;
  • one URL — for all event types across selected channels;
  • different URLs — for different event types across selected channels;
  • up to two URLs can be specified for each event type within a single channel.

Master webhooks​

  • Configured manually in the Integration → Settings → Main profile tab in your edna Pulse account or via API.
  • Apply to the entire account.
  • Each master webhook processes only its own event type across all channels in the personal account.
  • Applies to all channels.
  • Master webhooks send events only for those channels for which no additional webhooks are configured.
  • You can delete or change the URL for each event type.

Additional webhooks​

  • Configured manually on the Integration → Settings → Webhooks tab in your edna Pulse account or via the API.
  • Can be applied to selected channels.
  • If an additional webhook is configured for a channel, events for that channel are sent only through it.
  • Allow you to set specific event processing parameters.
  • You can specify up to two URLs for each event type within a single channel.
  • You can delete or modify URLs for configured webhooks.