How can I change Whatsapp Profile picture? How can I change Whatsapp Profile picture?

How can I change Whatsapp Profile picture?

Vonage API Support

Objective

  • How can I change WhatsApp Profile picture?
  • How can I change WhatsApp logo?

Applies To

  • Messages API
  • WhatsApp

Prerequisites

Before proceeding, ensure the following:

  • Your WhatsApp number is already onboarded and has a Connected status in the Vonage Dashboard.
  • You have access to the Vonage API Dashboard with the appropriate API key.
  • Your profile image is prepared and meets the file requirements listed below.

Image Requirements: The file must be a square JPG or PNG, with maximum dimensions of 640 x 640 pixels and a maximum file size of 800 KB. Prepare your image before starting to avoid interruptions during the upload step.

Procedure

There are three ways to update your WhatsApp Business Profile picture:

Option 1 — Via the Vonage Customer Dashboard (Recommended)

  1. Navigate to your https://dashboard.vonage.com/messages/social-channels.
  2. From the left menu, select Messaging.
  3. Select External Accounts.
  4. On the top of the left panel, click the Account drop-down. A Select account popup will appear listing all available API keys — select the one associated with your WhatsApp number.
    • If the WhatsApp number does not appear, try selecting a different API key from the drop-down list.
  5. Under Your connected external accounts, locate your WhatsApp number from the list filtered by the selected API key.
  6. Click Edit next to the WhatsApp number you wish to update.
  7. On the profile's Edit page, fill in the WhatsApp profile information and upload a new profile picture.
    • If prompted to select a Business Category, please do so. This is required to successfully upload a profile picture in some cases.
  8. Click Save.

Note: Sometimes the profile picture may appear distorted immediately after saving. This is a known display behaviour. Save the settings and refresh the page. If the picture still does not appear after refreshing, allow a few minutes for the change to propagate on WhatsApp's end before checking again.

1.jpg

 

3.jpg

2.jpg

Option 2 — Via the WhatsApp Business Portal (Meta)

  1. Navigate to the WhatsApp Business Account that hosts the number you wish to edit.
  2. In the left-hand navigation, go to Phone Numbers.
  3. Click the Settings toggle corresponding to the WhatsApp number you wish to edit.
  4. Select the Profile tab.
  5. Edit the necessary fields and upload a new profile picture.
  6. Click Save.

Option 3 — Via the Vonage WhatsApp Provisioning API

You can also update the profile picture programmatically using the https://developer.vonage.com/en/api/whatsapp-provisioning#Profile.

Troubleshooting

Issue Resolution
Profile picture saves successfully but disappears on refresh Ensure the image meets the size and format requirements (square JPG/PNG, max 640x640px, max 800KB). Also try clearing your browser cache and cookies.
Upload fails or prompts for a Business Category Select a Business Category from the dropdown when prompted and retry the upload. This is a known behaviour after Embedded Sign-Up onboarding.
Profile picture not visible to end users after saving Allow a few minutes for propagation. If the issue persists, save the settings again and refresh the page.
Unable to edit profile at all (Bad Request / "Fail to get number's profile" error) Your WhatsApp number may be in a locked or unverified state. Please contact https://api.support.vonage.com/hc/en-us/requests/new for assistance.

Additional Information

Related to:

WhatsApp display name

Articles in this section