Client Documentation
Get StartedStatus Page
  • 360Dialog
    • Why you should use 360dialog as Business Solution Provider (BSP)
    • Prices, plans and payment options
  • client hub
    • 360Dialog Client Hub
    • Numbers
      • Manage your WABA
        • Account Statuses
    • Activity
    • Funds
      • Month Closing Invoice (MCI)
    • Payment Management
    • API Keys
    • Template Message Management
    • Partner Change
    • Cancellation
    • Downgrade
  • WhatsApp Marketing
    • Best practices to maintain Account Health and prevent being blocked
    • Driving users to your WhatsApp account
      • WhatsApp Channels
    • Business Search
    • Linking a WABA to a Facebook Page /EN
      • Vinculando uma conta WABA à uma página do Facebook /PT
      • Cómo vincular un WABA a una página de Facebook /ES
    • Linking a WABA to Google Message Ads
    • Ads that Click to WhatsApp (CTWA) /EN
      • Anúncios de Clique para o WhatsApp (CTWA) /PT
        • Como usar o WhatsApp para marketing e vendas? /PT
      • Anuncios que Click to WhatsApp (CTWA) /ES
        • ¿Cómo usar WhatsApp para marketing y ventas? /ES
    • Conversions API (CAPI)
    • Create Ads lookalike audience based on WhatsApp events
    • MM Lite API Beta
      • Onboarding
      • Sending Messages
  • waba basics
    • WhatsApp Business Platform
    • WhatsApp Accounts structure
    • WABA for Government Agencies
    • WABA Policy Enforcement
    • Architecture and Security
    • The Basics (Overview)
    • Webhook Events and Notifications
    • Messaging API
      • Messaging Health Status
      • Step to Step to move to Cloud API
        • [will be deprecated] WABA Integration (On-Premise)
    • Migrating Phone Numbers
      • Migrate number from Meta or alternate BSP to 360dialog Cloud API
      • Migrate a phone number to a new WABA
      • Migrate to alternate BSP
  • waba management
    • Creating new WABA
      • Using a new phone number
      • WhatsApp Coexistence
        • Coexistence Onboarding
        • Coexistence Webhooks
    • Display Name Guidelines
    • Meta Business Verification
    • Official Business Account (OBA) or blue badge
    • WABA Profile Info
    • Capacity, Quality Rating, and Messaging Limits
      • Accelerated Onboarding
    • Hosting type Change
  • waba Messaging
    • Sandbox (Test API Key)
    • Receiving messages
    • Before sending a message
      • Checklist for Message Broadcasts and Campaigns
    • Conversations
    • Messaging
    • Conversational Components
    • Media Messages
      • Upload, retrieve or delete media
    • Template Messages
      • Template Elements
      • Sending Template Messages
      • Authentication Templates
        • Zero-Tap Authentication Templates
        • One-Tap Autofill Authentication Templates
        • Copy Code Authentication Templates
      • Catalog Templates
      • Product Card Carousel Templates
      • Single-Product Message Templates
      • Coupon Code Templates
      • Limited-Time Offer Templates
      • Multi-Product Templates
    • Interactive Messages
      • Single and Multi Product Messages
      • Location Request Message
    • Flows
    • Products & Catalogs
    • Contacts and Location Messages
    • Payments (India Only)
      • Receive WhatsApp Payments via Payments Gateway
      • Receive WhatsApp Payments via Payment Links
      • Order Details Template Message
    • Payments (Singapore only)
      • Receive WhatsApp Payments via Stripe
  • Partners
    • Partner Documentation
  • Support
    • Help and Support
      • Opening Hours & Response Time
      • Status Pages
      • Meta Support
      • Common Issues
      • How to contact Support
    • Error Messages
    • Imprint & Data Privacy
    • FAQ
Powered by GitBook
On this page
  • In the 360dialog Client Hub
  • In the API
  • Retrieve Business Profile information
  • Update Business Profile Information
  • Resumable Upload API for Profile Pictures
  • [will be deprecated] If the WABA is registered in On-premise API
  • Profile: About
  • Profile: About
  • Profile: Photo
  • Business Profile

Was this helpful?

  1. waba management

WABA Profile Info

This document describes how to manage your WABA Profile Info

PreviousOfficial Business Account (OBA) or blue badgeNextCapacity, Quality Rating, and Messaging Limits

Last updated 1 year ago

Was this helpful?

In the 360dialog Client Hub

You can update your WABA profile information in the .

In the API

Retrieve Business Profile information

GET https://waba-v2.360dialog.io/whatsapp_business_profile?fields=about,address,description,email,profile_picture_url,websites,vertical

Use this edge to retrieve the information available in the Business Profile: business address, business description, email for business contact, business industry, and business website.

Request example

GET /whatsapp_business_profile?fields=about,address,description,email,profile_picture_url,websites,vertical'

Request Body

Name
Type
Description

address

string

Address of the business. Maximum of 256 characters

description

String

Description of business. Maximum of 512 characters.

email

String

Email address (in valid email format) to contact the business. Maximum of 128 characters.

vertical

String

Industry of the business. Must be one of these accepted values: UNDEFINED / OTHER / AUTO / BEAUTY / APPAREL / EDU / ENTERTAIN / EVENT_PLAN / FINANCE / GROCERY / GOVT / HOTEL / HEALTH / NONPROFIT / PROF_SERVICES / RETAIL / TRAVEL / RESTAURANT / NOT_A_BIZ . The business vertical cannot be set back to an empty value after it is created.

websites

array of strings

URLs (including http:// or https://) associated with the business (e.g., website, Facebook Page, Instagram). Maximum of 2 websites with a maximum of 256 characters each.

about

string

Optional.

The business's About text. This text appears in the business's profile, beneath its profile image, phone number, and contact buttons.

*String cannot be empty.

*Strings must be between 1 and 139 characters.

*Rendered emojis are supported however their unicode values are not.

*Emoji unicode values must be Java- or JavaScript-escape encoded.

*Hyperlinks can be included but will not render as clickable links.

*Markdown is not supported.

A successful response includes the profile object containing the business profile data.

{
  "data": [{
    "about": "ABOUT",
    "address": "ADDRESS",
    "description": "DESCRIPTION",
    "email": "EMAIL",
    "messaging_product": "whatsapp",
    "profile_picture_url": "https://URL",
    "websites": [
       "https://WEBSITE-1",
       "https://WEBSITE-2"
     ],
    "vertical": "INDUSTRY",
  }]
}

Update Business Profile Information

POST https://waba-v2.360dialog.io/whatsapp_business_profile

Use the endpoint to configure the following business profile settings: business address, business description, email for business contact, business industry, and business website.

If you only need to update a couple of fields with new information, you can make a request which changes only the necessary fields.

You can use the profile_picture_handle parameter to update the profile photo. HANDLE_OF_PROFILE_PICTURE is url obtained from the Resumable Upload API.

Request example

curl -X POST 'https://waba-v2.360dialog.io/whatsapp_business_profile' -H 'D360-API-KEY: YOUR_API_KEY' -d '{ "messaging_product": "whatsapp", "about": "ABOUT", "address": "ADDRESS", "description": "DESCRIPTION", "vertical": "INDUSTRY", "email": "EMAIL", "websites": [ "https://WEBSITE-1", "https://WEBSITE-2" ], "profile_picture_handle": "HANDLE_OF_PROFILE_PICTURE" }'

Request Body

Name
Type
Description

vertical

array

Industry of the business. Must be one of these accepted values: UNDEFINED / OTHER / AUTO / BEAUTY / APPAREL / EDU / ENTERTAIN / EVENT_PLAN / FINANCE / GROCERY / GOVT / HOTEL / HEALTH / NONPROFIT / PROF_SERVICES / RETAIL / TRAVEL / RESTAURANT / NOT_A_BIZ

The business vertical cannot be set back to an empty value after it is create

websites

array

URLs associated with the business.

email

string

Email address (in valid email format) to contact the business. Maximum of 128 characters

description

string

Description of the business. Max 512 characters.

address

string

Address of the business. Maximum of 256 characters

about

string

Optional.

The business's About text. This text appears in the business's profile, beneath its profile image, phone number, and contact buttons.

*String cannot be empty.

*Strings must be between 1 and 139 characters.

*Rendered emojis are supported however their unicode values are not.

*Emoji unicode values must be Java- or JavaScript-escape encoded.

*Hyperlinks can be included but will not render as clickable links.

*Markdown is not supported.

{
    // Response
}

Resumable Upload API for Profile Pictures

Please note that to access and utilize the Resumable Upload API, it is mandatory to include the 360dialog-API-key within the header.

Step 1: Create a Session

Send a POST request that describes your file to the endpoint /uploads.Upon success, an upload session ID will be returned that you can use in the next step to initiate the upload.

Request Syntax

POST-https://waba-v2.360dialog.io/uploads
  &file_length={file-length}
  &file_type={file-type}

​Parameters

Parameter
Description

file_length int64

The file length in bytes

file_type RegexParam

The MIME type of the file to be uploaded

Response

  • {id} — Upload session ID.

Sample Request

curl -X POST \
 "https://waba-v2.360dialog.io/uploads?file_length=109981&file_type=image/png"

Sample Response

{
    "id": "upload:MTphd..."
}

Step 2: Initiate Upload

Initiate the upload session by sending a POST request and append your upload session {id} along with the authentication header. Upon success, a file handle {h},is returned that you can then use the {h} value to update your profile picture.

Request Syntax

POST waba-v2.360dialog.io/{session_id}  
--header 'file_offset: 0'
--data-binary @{file-name}

Placeholder Values

  • {session_id} — Upload session ID returned in step 1.

  • {file-name} — Name of the file to upload.

Response

{
  "h": "{h}"
}

Response property values:

  • {h} — The uploaded file's file handle

Sample Request

curl -X POST \
 "https://waba-v2.360dialog.io/upload:MTphd..." \

Sample Response

{
    "h": "2:c2FtcGxl..."
} 

Remember The [base-path] for Cloud API is https://waba-v2.360dialog.io. Every request to WhatsApp API needs to be authorized using API Key authentication. Adding theD360-API-KEY header with your API Key as a value will give you permission.

[will be deprecated] If the WABA is registered in On-premise API

As announced in November 2023, Meta is transitioning to a fully Cloud-hosted WhatsApp Business Platform and will stop supporting On-Premise API in October 2025.

Starting from On-Premise client v2.53, all new feature updates will be exclusively delivered to Cloud API. While the On-Premise API client will receive quarterly releases, they will focus solely on bug fixes and security patches. From May 15, 2024, 360dialog will not allow for new numbers to be onboarded with On-Premise API. We will continue supporting already registered On-Premise API throughout 2024, but we strongly recommend to start changing the hosting type of numbers to Cloud as soon as possible. Learn here how to integrate with Cloud API.

Profile: About

GET https://[base-path]/v1/settings/profile/about

Use this edge to retrieve your profile's About section.

{
  "settings": {
    "profile": {
      "about": {
        "text": "your-profile-about-text"
      }
    }
  }

Profile: About

PATCH https://[base-path]/v1/settings/profile/about

Use this edge to manage your profile's About section.

Request Body

Name
Type
Description

text

string

{
    "meta": {
        "api_status": "stable",
        "version": "2.33.4"
    }
}

Profile: Photo

POST https://[base-path]/v1/settings/profile/photo

Use this endpoint to manage your profile photo.

Request Body

Name
Type
Description

object

Your binary image content

{
    "meta": {
        "api_status": "stable",
        "version": "2.33.4"
    }
}

Example in Postman

Business Profile

POST https://[base-path]/v1/settings/business/profile

Use the endpoint to configure the following business profile settings: business address, business description, email for business contact, business industry, and business website.

Request Body

Name
Type
Description

vertical

array

Industry of the business.

websites

array

URLs associated with the business.

email

string

Business email

description

string

Description of the business. Max 256 characters.

address

string

Address of the business

about

string

Optional.

The business's About text. This text appears in the business's profile, beneath its profile image, phone number, and contact buttons.

*String cannot be empty.

*Strings must be between 1 and 139 characters.

*Rendered emojis are supported however their unicode values are not.

*Emoji unicode values must be Java- or JavaScript-escape encoded.

*Hyperlinks can be included but will not render as clickable links.

*Markdown is not supported.

{
    "meta": {
        "api_status": "stable",
        "version": "2.33.4"
    }
}

The allows you to upload profile pictures and essentially large files to the Cloud API. Once uploaded, you can use a file's handle fetched in to update your .

You can then use the endpoint to update the profile photo using the {h} value.

Please review the for the full list of acceptable parameter values.

You can use the following endpoints to set your WhatsApp profile info in the same manner as described in on the topic.

Please review the for the full list of acceptable parameter values.

360dialog Client Hub
official WhatsApp docs
the official WhatsApp documentation
official WhatsApp docs
Resumable Upload API
step 2
profile_picture_handle
Update Business Profile information
Example using Postman