Skip to main content
PATCH
Update User
Update the account or user data of the social network. Currently Google Business Profile and WhatsApp are supported.
Google limits updating some Google Business Profile location fields to being updated 5 times within a rolling 24-hour period. For example updating phoneNumbers more than 5 times in a rolling 24-hour period will return a 400 Response. This limit is specific to Google Business Profile and does not apply to WhatsApp.

Header Parameters

Path Parameters

string
required
Values: gbp, whatsapp

Body Parameters

object
Object containing the different phone numbers that customers can use to get in touch with the business.
string
Google identifier for this location in the form.
string
An alternate phone number to display on AdWords location extensions instead of the location’s primary phone number.
string
External identifier for this location, which must be unique within a given account. This is a means of associating the location with your own records.
string
Location name should reflect your business’s real-world name, as used consistently on your storefront, website, and stationery, and as known to customers.
string
A URL for this business.
array
A collection of free-form strings to allow you to tag your business. These labels are not user facing; only you can see them. Must be between 1-255 characters per label.
object
An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard.
Values must be within normalized ranges.The latitude in degrees. It must be in the range [-90.0, +90.0].The longitude in degrees. It must be in the range [-180.0, +180.0].
object
This field contains a description of the location in your own voice. The description is not editable by anyone else.

WhatsApp

WhatsApp is in Private Beta. Updating a WhatsApp business profile requires an account approved for WhatsApp. If you’d like early access, email lotty@ayrshare.com.
Send only the fields you want to change. At least one is required, and sending a field that this endpoint does not recognize rejects the entire request. To clear a field, send it as an empty string: {"description": ""} removes the description, and the field then stops appearing in the profile at all. This works for description, address and email. It does not work for about, which WhatsApp requires to be at least one character — to change that one, overwrite it. vertical cannot be cleared either, once it has been set. The response fields messaging_product and profile_picture_url (see WhatsApp Business Profile) are read-only: sending either one back is rejected as an unrecognized field. Use profilePictureUrl to set the photo.
string
Text shown beneath the profile image. 1–139 characters. This is the one text field WhatsApp will not let you clear — overwrite it instead.
string
Business description. Up to 512 characters. Send "" to clear it.
string
Business address. Up to 256 characters. Send "" to clear it.
string
Contact email address. Up to 128 characters, and must be a valid address unless you are sending "" to clear it.
array
A non-empty array of up to 2 URLs, each starting with http:// or https://.
string
Business category. WhatsApp currently accepts: OTHER, AUTO, BEAUTY, APPAREL, EDU, ENTERTAIN, EVENT_PLAN, FINANCE, GROCERY, GOVT, HOTEL, HEALTH, NONPROFIT, PROF_SERVICES, RETAIL, TRAVEL, RESTAURANT, ALCOHOL, ONLINE_GAMBLING, PHYSICAL_GAMBLING, OTC_DRUGS, MATRIMONY_SERVICE. This list is WhatsApp’s and may grow over time — Ayrshare does not restrict the value, so any category WhatsApp accepts works. Normalized to uppercase, so a value sent as retail is returned as RETAIL. WhatsApp does not allow the category to be cleared once it has been set, and rejects a value it does not accept — the rejection is returned as a 101 with WhatsApp’s own message naming the currently accepted values.
string
Publicly reachable JPEG or PNG, 5 MB or smaller. The image must be square and at least 192×192 — 640×640 is recommended. There is no maximum resolution: a larger image is accepted and scaled down by WhatsApp. An image that is not square or is below 192×192 is rejected with a 400 naming the problem, before anything is sent to WhatsApp. See the WhatsApp media guidelines for the full requirements.