Disconnect WhatsApp Business account

import { Photon } from "@photon-ai/api";

const photon = new Photon({
  headers: { Authorization: `Bearer ${process.env.PHOTON_API_TOKEN}` },
});
const result = await photon.projects.platforms.disconnectWhatsappBusinessAccount({
  path: {
    id: "id",
  },
  headers: {
    idempotencyKey: "idempotencyKey",
  },
});

import os

from photon_api import Photon
from photon_api.rpc_generated import DisconnectWhatsappBusinessAccountInput

photon = Photon(headers={"Authorization": f"Bearer {os.environ['PHOTON_API_TOKEN']}"})
result = photon.projects.platforms.disconnect_whatsapp_business_account(
    DisconnectWhatsappBusinessAccountInput.model_validate({
        "path": {
            "id": "id",
        },
        "headers": {
            "Idempotency-Key": "idempotencyKey",
        },
    })
)

use photon_ai_api::{Credential, PhotonClientBuilder, SecretString};

let token = std::env::var("PHOTON_API_TOKEN")?;
let client = PhotonClientBuilder::new()
    .credential("accountServiceKey", Credential::Bearer(SecretString::from(token)))
    .build()?;
let result = client
    .disconnect_whatsapp_business_account("idempotencyKey".to_owned(), "id".to_owned())
    .await
    .map_err(|error| format!("{error:?}"))?
    .into_inner();

{
  "cancellable": true,
  "createdAt": "2026-01-01T00:00:00.000Z",
  "detail": {},
  "endedAt": "2026-01-01T00:00:00.000Z",
  "error": {
    "code": "string",
    "detail": "string"
  },
  "operationId": "string",
  "projectId": "string",
  "reason": "charge_refused",
  "resourceId": "string",
  "resourceType": "string",
  "startedAt": "2026-01-01T00:00:00.000Z",
  "state": "pending",
  "type": "resource.provision",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

{
  "cancellable": true,
  "createdAt": "2026-01-01T00:00:00.000Z",
  "detail": {},
  "endedAt": "2026-01-01T00:00:00.000Z",
  "error": {
    "code": "string",
    "detail": "string"
  },
  "operationId": "string",
  "projectId": "string",
  "reason": "charge_refused",
  "resourceId": "string",
  "resourceType": "string",
  "startedAt": "2026-01-01T00:00:00.000Z",
  "state": "pending",
  "type": "resource.provision",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

import { Photon } from "@photon-ai/api";

const photon = new Photon({
  headers: { Authorization: `Bearer ${process.env.PHOTON_API_TOKEN}` },
});
const result = await photon.projects.platforms.disconnectWhatsappBusinessAccount({
  path: {
    id: "id",
  },
  headers: {
    idempotencyKey: "idempotencyKey",
  },
});

import os

from photon_api import Photon
from photon_api.rpc_generated import DisconnectWhatsappBusinessAccountInput

photon = Photon(headers={"Authorization": f"Bearer {os.environ['PHOTON_API_TOKEN']}"})
result = photon.projects.platforms.disconnect_whatsapp_business_account(
    DisconnectWhatsappBusinessAccountInput.model_validate({
        "path": {
            "id": "id",
        },
        "headers": {
            "Idempotency-Key": "idempotencyKey",
        },
    })
)

use photon_ai_api::{Credential, PhotonClientBuilder, SecretString};

let token = std::env::var("PHOTON_API_TOKEN")?;
let client = PhotonClientBuilder::new()
    .credential("accountServiceKey", Credential::Bearer(SecretString::from(token)))
    .build()?;
let result = client
    .disconnect_whatsapp_business_account("idempotencyKey".to_owned(), "id".to_owned())
    .await
    .map_err(|error| format!("{error:?}"))?
    .into_inner();

{
  "cancellable": true,
  "createdAt": "2026-01-01T00:00:00.000Z",
  "detail": {},
  "endedAt": "2026-01-01T00:00:00.000Z",
  "error": {
    "code": "string",
    "detail": "string"
  },
  "operationId": "string",
  "projectId": "string",
  "reason": "charge_refused",
  "resourceId": "string",
  "resourceType": "string",
  "startedAt": "2026-01-01T00:00:00.000Z",
  "state": "pending",
  "type": "resource.provision",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

{
  "cancellable": true,
  "createdAt": "2026-01-01T00:00:00.000Z",
  "detail": {},
  "endedAt": "2026-01-01T00:00:00.000Z",
  "error": {
    "code": "string",
    "detail": "string"
  },
  "operationId": "string",
  "projectId": "string",
  "reason": "charge_refused",
  "resourceId": "string",
  "resourceType": "string",
  "startedAt": "2026-01-01T00:00:00.000Z",
  "state": "pending",
  "type": "resource.provision",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

DELETE /v1/projects/{id}/platforms/whatsapp-business/account Disconnects every attached WhatsApp sender, then unsubscribes our app and removes the project’s business account connection. Photon VoIP lines and the numbers in Meta remain. Requires Idempotency-Key. Poll the returned operation; provider refusals appear as operation failures and retain the account for retry with a new key. New signups are blocked while disconnecting, and existing provisions must finish before this request can be accepted.

TypeScript
Python
Rust

TypeScript

photon.projects.platforms.disconnectWhatsappBusinessAccount(input: DisconnectWhatsappBusinessAccountInput, options?: RequestOptions): Promise<DisconnectWhatsappBusinessAccountOutput>

Python

photon.projects.platforms.disconnect_whatsapp_business_account(input: DisconnectWhatsappBusinessAccountInput) -> models.Operation

Rust

client.disconnect_whatsapp_business_account(idempotency_key: String, id: String).await -> Result<ResponseValue<DisconnectWhatsappBusinessAccountResponse>, Error<DisconnectWhatsappBusinessAccountError>>

import { Photon } from "@photon-ai/api";

const photon = new Photon({
  headers: { Authorization: `Bearer ${process.env.PHOTON_API_TOKEN}` },
});
const result = await photon.projects.platforms.disconnectWhatsappBusinessAccount({
  path: {
    id: "id",
  },
  headers: {
    idempotencyKey: "idempotencyKey",
  },
});

import os

from photon_api import Photon
from photon_api.rpc_generated import DisconnectWhatsappBusinessAccountInput

photon = Photon(headers={"Authorization": f"Bearer {os.environ['PHOTON_API_TOKEN']}"})
result = photon.projects.platforms.disconnect_whatsapp_business_account(
    DisconnectWhatsappBusinessAccountInput.model_validate({
        "path": {
            "id": "id",
        },
        "headers": {
            "Idempotency-Key": "idempotencyKey",
        },
    })
)

use photon_ai_api::{Credential, PhotonClientBuilder, SecretString};

let token = std::env::var("PHOTON_API_TOKEN")?;
let client = PhotonClientBuilder::new()
    .credential("accountServiceKey", Credential::Bearer(SecretString::from(token)))
    .build()?;
let result = client
    .disconnect_whatsapp_business_account("idempotencyKey".to_owned(), "id".to_owned())
    .await
    .map_err(|error| format!("{error:?}"))?
    .into_inner();

{
  "cancellable": true,
  "createdAt": "2026-01-01T00:00:00.000Z",
  "detail": {},
  "endedAt": "2026-01-01T00:00:00.000Z",
  "error": {
    "code": "string",
    "detail": "string"
  },
  "operationId": "string",
  "projectId": "string",
  "reason": "charge_refused",
  "resourceId": "string",
  "resourceType": "string",
  "startedAt": "2026-01-01T00:00:00.000Z",
  "state": "pending",
  "type": "resource.provision",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

{
  "cancellable": true,
  "createdAt": "2026-01-01T00:00:00.000Z",
  "detail": {},
  "endedAt": "2026-01-01T00:00:00.000Z",
  "error": {
    "code": "string",
    "detail": "string"
  },
  "operationId": "string",
  "projectId": "string",
  "reason": "charge_refused",
  "resourceId": "string",
  "resourceType": "string",
  "startedAt": "2026-01-01T00:00:00.000Z",
  "state": "pending",
  "type": "resource.provision",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}

Parameters

string

required

Identifies one logical mutation across retries.

string

required

Returns

200 The replayed disconnect operation is terminal. Operation

boolean

required

string (date-time)

required

object

string (date-time)

OperationError

string

required

string

required

OperationReason

string

required

string (date-time)

OperationState

required

OperationType

required

string (date-time)

required

202 Account disconnect accepted. Poll Location after Retry-After. Operation Headers: Location. The raw response carries these headers; see Raw responses.

boolean

required

string (date-time)

required

object

string (date-time)

OperationError

string

required

string

required

OperationReason

string

required

string (date-time)

OperationState

required

OperationType

required

string (date-time)

required

⌘I

Get started

Guides

Reference

SDK reference

Disconnect WhatsApp Business account

Parameters

Returns

​Parameters

​Returns

Parameters

Returns