Connect WhatsApp Business

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

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

import os

from photon_api import Photon
from photon_api.rpc_generated import ConnectWhatsappBusinessInput

photon = Photon(headers={"Authorization": f"Bearer {os.environ['PHOTON_API_TOKEN']}"})
result = photon.projects.platforms.connect_whatsapp_business(
    ConnectWhatsappBusinessInput.model_validate({
        "path": {
            "id": "id",
        },
        "headers": {
            "Idempotency-Key": "idempotencyKey",
        },
        "body": {
            "code": "code",
            "phoneNumberId": "phoneNumberId",
            "wabaId": "wabaId",
        },
    })
)

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
    .connect_whatsapp_business(
        "idempotencyKey".to_owned(),
        "id".to_owned(),
        &serde_json::from_value(serde_json::json!({
            "code": "code",
            "phoneNumberId": "phoneNumberId",
            "wabaId": "wabaId",
        }))?,
    )
    .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"
}

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

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

import os

from photon_api import Photon
from photon_api.rpc_generated import ConnectWhatsappBusinessInput

photon = Photon(headers={"Authorization": f"Bearer {os.environ['PHOTON_API_TOKEN']}"})
result = photon.projects.platforms.connect_whatsapp_business(
    ConnectWhatsappBusinessInput.model_validate({
        "path": {
            "id": "id",
        },
        "headers": {
            "Idempotency-Key": "idempotencyKey",
        },
        "body": {
            "code": "code",
            "phoneNumberId": "phoneNumberId",
            "wabaId": "wabaId",
        },
    })
)

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
    .connect_whatsapp_business(
        "idempotencyKey".to_owned(),
        "id".to_owned(),
        &serde_json::from_value(serde_json::json!({
            "code": "code",
            "phoneNumberId": "phoneNumberId",
            "wabaId": "wabaId",
        }))?,
    )
    .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"
}

POST /v1/projects/{id}/platforms/whatsapp-business/numbers Exchanges the authorization code Embedded Signup returned and connects exactly the selected phone number as one whatsapp_sender. Send the WABA id and phone-number id emitted by the same popup attempt; both are treated as selectors and verified against Meta before use. A selected number that matches a non-retired, same-project voip_line is linked to it; a number absent from Photon inventory stays unbound; a matching non-retired cosmos_line, foreign VoIP line or unassigned VoIP line fails the operation before registration. Connecting is free — no plan requirement — but Billing must report the project’s organization as ready with a payment method on file. The Idempotency-Key is required and permanent: replaying the same key returns the original operation forever. Requires the platforms:write permission bound to the project resource in the path.

TypeScript
Python
Rust

TypeScript

photon.projects.platforms.connectWhatsappBusiness(input: ConnectWhatsappBusinessInput, options?: RequestOptions): Promise<ConnectWhatsappBusinessOutput>

Python

photon.projects.platforms.connect_whatsapp_business(input: ConnectWhatsappBusinessInput) -> models.Operation

Rust

client.connect_whatsapp_business(idempotency_key: String, id: String, body: &types::ConnectWhatsappBusinessRequest).await -> Result<ResponseValue<types::Operation>, Error<ConnectWhatsappBusinessError>>

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

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

import os

from photon_api import Photon
from photon_api.rpc_generated import ConnectWhatsappBusinessInput

photon = Photon(headers={"Authorization": f"Bearer {os.environ['PHOTON_API_TOKEN']}"})
result = photon.projects.platforms.connect_whatsapp_business(
    ConnectWhatsappBusinessInput.model_validate({
        "path": {
            "id": "id",
        },
        "headers": {
            "Idempotency-Key": "idempotencyKey",
        },
        "body": {
            "code": "code",
            "phoneNumberId": "phoneNumberId",
            "wabaId": "wabaId",
        },
    })
)

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
    .connect_whatsapp_business(
        "idempotencyKey".to_owned(),
        "id".to_owned(),
        &serde_json::from_value(serde_json::json!({
            "code": "code",
            "phoneNumberId": "phoneNumberId",
            "wabaId": "wabaId",
        }))?,
    )
    .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"
}

Parameters

string

required

Identifies one logical mutation across retries.

string

required

Body

string

required

string

required

string

required

Returns

202 The code was accepted and onboarding was dispatched. GET the Location after the Retry-After interval until the operation is terminal. 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

Connect WhatsApp Business

Parameters

Body

Returns

​Parameters

​Body

​Returns

Parameters

Body

Returns