Invitations

Not generated in the Python SDK yet. The zavudev package does not expose an invitations resource today, so there is nothing to call. The endpoints exist and are stable: use the REST API below, the CLI, or the TypeScript SDK, which does cover it. See the coverage table.

Partner invitations generate a link a client opens to connect their own WhatsApp Business Account, or a Facebook Page, into your project. One invitation connects one channel.

Create an invitation

curl -X POST https://api.zavu.dev/v1/invitations \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "clientName": "Acme Corp",
    "clientEmail": "contact@acme.com",
    "connectionType": "whatsapp_waba",
    "expiresInDays": 14
  }'

The response carries url, the link you share with the client, and token.

CLI

npx zavudev invitations create --data '{"clientName":"Acme Corp"}'

Retrieve an invitation

curl https://api.zavu.dev/v1/invitations/inv_abc123 \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"

Poll status (pending, in_progress, completed, expired, cancelled, failed), or subscribe to the invitation.status_changed webhook instead of polling. A failed invitation is still usable: the same link can be retried.

List invitations

curl "https://api.zavu.dev/v1/invitations?status=pending&limit=50" \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"

Cancel an invitation

curl -X POST https://api.zavu.dev/v1/invitations/inv_abc123/cancel \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"

After completion

When the client finishes, the invitation moves to completed and carries senderId plus connectedAccount (the WhatsApp number or Facebook Page that was linked). That sender is now yours to send from.

Partner invitations guide

The full flow, webhooks, and failure codes

API reference

Every field on the endpoint

​Create an invitation

​Retrieve an invitation

​List invitations

​Cancel an invitation

​After completion

Partner invitations guide

API reference

Create an invitation

Retrieve an invitation

List invitations

Cancel an invitation

After completion