Upload media

POST

{phone_number_id}

media

curl --request POST \
  --url https://api.kapso.ai/meta/whatsapp/v24.0/{phone_number_id}/media \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form messaging_product=whatsapp \
  --form file='@example-file'

{
  "id": "4490709327384033"
}

{
  "error": {
    "message": "Invalid phone number format",
    "type": "OAuthException",
    "code": 400,
    "error_subcode": 1001,
    "fbtrace_id": "AXk7s_8dR4eVHp9Kq2MmNlO"
  }
}

{
  "error": {
    "message": "Invalid phone number format",
    "type": "OAuthException",
    "code": 400,
    "error_subcode": 1001,
    "fbtrace_id": "AXk7s_8dR4eVHp9Kq2MmNlO"
  }
}

Authorizations

X-API-Key

string

header

required

Project API key for authentication. This is the recommended authentication method.

Get your API key from the Kapso dashboard under Integrations > API keys.

Path Parameters

phone_number_id

string

required

WhatsApp Business Phone Number ID

Body

multipart/form-data

file

required

Media file to upload

messaging_product

enum<string>

required

Always "whatsapp"

Available options:

whatsapp

Response

Media uploaded successfully

string

Media ID to use when sending messages

Example:

"4490709327384033"

Get media URLRetrieve the download URL for a media file. **Important:** The returned URL is temporary and expires after 5 minutes.

curl --request POST \
  --url https://api.kapso.ai/meta/whatsapp/v24.0/{phone_number_id}/media \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form messaging_product=whatsapp \
  --form file='@example-file'

{
  "id": "4490709327384033"
}

{
  "error": {
    "message": "Invalid phone number format",
    "type": "OAuthException",
    "code": 400,
    "error_subcode": 1001,
    "fbtrace_id": "AXk7s_8dR4eVHp9Kq2MmNlO"
  }
}

{
  "error": {
    "message": "Invalid phone number format",
    "type": "OAuthException",
    "code": 400,
    "error_subcode": 1001,
    "fbtrace_id": "AXk7s_8dR4eVHp9Kq2MmNlO"
  }
}

Overview

WhatsApp API

Platform API

Workflows API

Authorizations

Path Parameters

Body

Response