Skip to content
DashboardGet API key

Cancel invitation

View .md
POST

Cancel an active invitation. The client will no longer be able to use the invitation link.

Authorization

  • Authorizationheaderrequired

    Bearer YOUR_API_KEY. Create a key in the dashboard.

Path parameters

  • invitationIdstringrequired

Responses

200Invitation cancelled.
  • invitationobjectrequired
    19 properties
    • idstringrequired
    • urlstringrequired

      Full URL to share with the client.

    • tokenstringrequired

      Unique invitation token.

    • clientNamestringnullable
    • clientEmailstringnullable
    • clientPhonestringnullable
    • phoneNumberIdstringnullable

      ID of a pre-assigned Zavu phone number for WhatsApp registration. Always null for messenger invitations.

    • connectionTypestring

      Which Meta channel the client connects: whatsapp_waba (official WhatsApp Cloud API via embedded signup) or messenger (a Facebook Page's Messenger inbox, including Marketplace chats).

      One ofwhatsapp_wabamessenger
    • statusstringrequired

      Current status of the partner invitation.

      failed means the client started the connection and it did not finish (they cancelled Meta's dialog, denied a permission, or abandoned the tab). A failed invitation is still usable: the same link can be retried, and it moves back to in_progress when the client tries again.

      One ofpendingin_progresscompletedexpiredcancelledfailed
    • senderIdstringnullable

      ID of the sender created when invitation is completed.

    • connectedAccountobjectnullable

      The account the client linked, populated once the invitation is completed. Null before that. Use it to show the partner what was connected without fetching the sender.

      3 properties
      • channelstringrequired
        One ofwhatsappmessenger
      • idstringrequired

        Provider-side identifier: the WhatsApp phone number ID, or the Facebook Page ID.

      • namestringnullable

        Display name of the connected account: the WhatsApp verified name, or the Facebook Page name.

    • failureReasonstringnullable

      Stable code for why the last attempt failed, present when status is failed. Values include fb_cancelled (client closed Meta's dialog), fb_not_authorized (permission denied), signup_abandoned (started but never finished), meta_no_pages (the client administers no Facebook Page), and internal_error. Treat unknown codes as a generic failure.

    • failedAtstring<date-time>nullable
    • expiresAtstring<date-time>required
    • viewedAtstring<date-time>nullable
    • startedAtstring<date-time>nullable
    • completedAtstring<date-time>nullable
    • createdAtstring<date-time>required
    • updatedAtstring<date-time>required
400Cannot cancel this invitation (already completed or cancelled).
  • codestringrequired
  • messagestringrequired
  • detailsobject
401Unauthorized.
  • codestringrequired
  • messagestringrequired
  • detailsobject
404Invitation not found.
  • codestringrequired
  • messagestringrequired
  • detailsobject