> ## Documentation Index
> Fetch the complete documentation index at: https://docs.birdeye.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Update
> Update Business API updates business information.
## OpenAPI
````yaml api/openapi.yaml PUT /v1/business/{businessId}
openapi: 3.0.0
info:
title: Birdeye
version: 0.0.1
description: >-
Birdeye helps businesses grow through happy customers. Over 80,000
businesses use Birdeye everyday to attract new leads with Listings, Reviews
and Referrals, convert them into customers with Webchat, Appointments, and
Payments, and delight those customers with Surveys, Ticketing, and Insights
- all in one place.
The Birdeye APIs are built on HTTP and are RESTful APIs.
* Uses resource-oriented URLs.
* Uses built-in HTTP capabilities for passing parameters and authentication.
* Responds with standard HTTP response codes to indicate errors.
* Requests and responses payload attached with all the mentioned APIs, you
may choose your preferred language per the integration requirement.
### Authentication and Rate limiting
> __NOTE:__
> - __All API requests targeting business accounts must include the
x-api-key header. This header is required and mandatory for successful
authentication and access to the API endpoints.__
>
> - __To protect your API key and prevent unauthorized access, please ensure
all API requests are made from your backend server. Do not call the APIs
directly from the browser or expose your API key in any client-side code.__
To call a Birdeye API, you need a valid API key. It can be fetched via the
Birdeye dashboard and is a confidential key.
There is a limit to calling APIs with each API key [connect with the support
team to get the current limit]. If too many requests are made within the
threshold timeframe, an error will be returned in the response.
### Pagination
Multiple API supporting pagination. These APIs have two parameters sindex
and count.
* sindex: is the start index
* count: No. of records, you want to fetch.
> __Note__
> - _Deep Pagination with record window greater than 100k is not supported.
Either reduce the sindex + count to be less than equal to 100k or use
appropriate filters to narrow down your result set._
For example :
* Suppose you have to fetch 20 records:
API call 1 -> sindex=0, count 10
API call 2 -> sindex -> 10, count 10.
* To fetch 100kth record:
sindex = 99000 and count = 1000
will just work fine as sindex + count = 100000 which is less than 100,000.
* If you fetch more than 100kth records:
sindex = 99000 and count = 1001, sindex + count = 100001
which is greater than 100,000. Thus, you'll receive an error in response.
### HTTP Status Codes
Every API response will have an HTTP status code.
* 200 - OK: API request is successful
* 202 - Accepted: The API request has been accepted for processing.
* 400 - Bad Request: The API request was unacceptable, often due to a
missing or invalid parameter.
* 404 - Not Found: The requested resource does not exist.
* 429 - Rate Limited: You have made too many requests within the
threshold timeframe.
* 500 - Internal Server Error: Something went wrong on our end.
Please get in touch with support.
### Error Response
Birdeye API will return a validation error in case of missing/invalid input
in the request. The response will return the errorCode and errorMessage.
For example :
{
"code": 1161,
"message": "Invalid API key"
}
servers:
- url: https://api.birdeye.com/resources
security: []
tags:
- name: Business
description: Create and maintain your business on Birdeye.
- name: Custom Fields
description: Create, delete , update , associate and get custom fields easily.
- name: User
description: Delete and manage user profiles and permissions easily.
- name: Reviews
description: Consistently generate more reviews and higher ratings.
- name: Contact
description: >-
Manage contacts across locations effortlessly with a robust Contact
Management System.
- name: Contact V2
description: >-
Easily manage contacts across multiple locations using enhanced Contact
APIs, featuring built-in support for communication preference flags.
- name: Campaign
description: >-
Create a short link for review requests and set review sources in the
template.
- name: Aggregation
description: Access your public data from 150+ review sites.
- name: Report
description: >-
Various reporting data points across Birdeye modules like reviews,
insights and competitors etc for all your data visualisation
- name: Survey
description: >-
Engage each customer at the right time with NPS or CSAT surveys to improve
your service.
- name: Business Media
description: >-
Add, delete and manage business media.
> __Supported Media Size__
> - _Photo: JPG or PNG. 720 x 720px. 10KB min._
> - _Video: 30 sec long. 720p or more upto 75MB._
> __Note__
> - _Uploaded media will be pushed to your google business profile (if
connected) and other long tail directories only._
- name: Social
description: Create and track Social posting for all channels.
- name: Employee
- name: Conversation
description: >-
Connect with customers across a range of digital channels from one unified
inbox.
- name: Subscription
description: >-
Subscribe or Unsubscribe multiple webhooks with different URLs or Events
for a subscription and deliver real-time notifications.
- name: Webhook
description: >-
Configure multiple webhooks with different URLs for a subscription and
deliver real-time notifications.
- name: Competitor
description: Make competitive insights your unfair advantage.
- name: Competitor AI
description: Competitive intelligence, simplified by AI.
- name: Insight AI
description: Insight intelligence, simplified by AI.
- name: Google Q&A
description: >-
> __Note__
> - _Applicable to be used only by paid listings clients, for their active
locations, for the Google Q&A section, in the Google listing_
- name: Google Services
description: >-
> __Note__
> - _Applicable to be used only by paid listings clients, for their active
locations, for the Google Services section, in the Google listing._
> - _No two services should have the same service name. It is recommended
that all services created should HAVE UNIQUE service names._
> - _You CAN have the same service across two diff categories e.g.:
Emergency counselling as a $100 paid service can be a service created &
mapped to category A - Mental health and category B - Psychotherapy - both
categories being present for the same location._
- name: FAQ
description: >-
To retrieve all Question and Answer (QnA) entries across locations using
FAQ APIs, enabling smart support and knowledge features for businesses.
- name: Listing
description: >-
Keep your business information accurate and consistent across 50+
websites.
- name: GMB Products
description: >-
To manage products, locations, and business details through Listing GMB
platform
- name: Search AI
description: >-
Search AI provides a comprehensive view of your business performance
across AI-powered search platforms, including data accuracy, sentiment
analysis, citations, brand ranking, and overall visibility.
- name: Ticketing
description: >-
Create standout customer support with ticketing across reviews, untagged,
and survey responses.
- name: Integration
description: Birdeye integrates with various software or tools you use.
- name: Change Logs
description: >-
* 07/03/2026 - Updated `mainBusinessDescription` and microsite
`internalListing.description` fields in Create, Update and Get Listing
APIs to be optional instead of required, with support for clearing the
existing value by sending an empty string (V2BIRD-1690).
* 06/10/2026 - Updated Get Contact API to support an optional
`experienceScore` boolean field in the request body (default: false). When
set to true, the response includes the customer's experience score and
source.
* 05/25/2026 - Added Update Custom card (PUT) and Delete Custom
card (DELETE) API documentation under the Business profile custom card
section.
* 05/11/2026 - Added support for backdated survey responses in the
POST Survey Response API. The `created` field (UTC Epoch milliseconds) is
optional; if omitted, the server defaults to the current UTC timestamp.
* 04/22/2026 - Provide subLocality field support in Get, Create and
Update Listings APIs for NZ Locations.
* 04/16/2026 - Added Archived Get Reviews API under Reviews group.
* 04/06/2026 - Updated Get Reviews API documentation to improve
clarity on review statuses and how to retrieve all review types.
* 03/24/2026 - Added Social Open URL Performance Report API and
Insight AI APIs to retrieve location-wise metrics and benchmark score.
* 03/18/2026 - Added Create Custom Card Time API under custom
fields section.
* 03/03/2026 - Added Response Time (overtime & by-location) and
Response Rate(overtime & by-location) APIs under reports section and
created group for Competitor AI.
* 03/02/2026 - Added sendInvite (boolean, default - true) field in
Create User Signup v2 API request body and attributes.
* 02/11/2026 - Updated the API key identifier for applicable APIs
by moving it from a query parameter to the x-api-key request header.
* 02/03/2026 - Added the "Get All QnA" API under FAQ group to
enable retrieval of QnA entries across business locations, with full
request and response documentation
* 01/19/2026 - Added a note under the Authentication and Rate
limiting section specifying that the x-api-key header is mandatory for all
API requests targeting EU region business accounts.
* 01/13/2026 - Added Create User (Signup) API under User module to
create and invite users for a business.
* 09/22/2025 - Added GMB Products APIs to onboard/connect Google
Merchant accounts and manage product listing actions.
* 08/21/2025 - Added Single main business description Support.
* 08/19/2025 - Added competitor /raptor public APIs for reviews
aggregates.
* 06/26/2025 - Added Contact V2 APIs with communication preference
flag support.
* 12/13/2024 - Added inline reply support for GetReviews APIs.
* 09/27/2024 - Added update for Google Opening Soon (BIRD-56987)
* 06/25/2024 - Updated Listings Insights API (BIRDEYE-137367)
* 05/29/2024 - Added Google Q&A Developers API Section
* 05/13/2024 - Added epoc date support for GetReviews APIs.
* 03/22/2024 - Add Update Hierarchy API (BIRD-32609)
* 03/19/2024 - Added Ticket APIs Create, Get, Update APIs under
Ticket module
* 02/26/2024 - Updated logoUrl description in Get, Update APIs
under Business module and Create, Get, Update APIs under Listing module
(BIRD-29386)
* 12/21/2023 - Add listing phase 2 api changes (BIRD-16589)
* 11/08/2023 - Add survey changes (BIRD-11944) and listing changes
(BIRD-14345)
* 11/08/2023 - Added CRUD APIs for Apple chat
* 10/15/2023 - Added CRUD APIs for Business Media.
* 10/11/2023 - Added new APIs under Listing module, Create, Update,
Get, Deactive Listings
* 09/18/2023 - Added new API under Contact module i.e, Get opt-out
contact data
* 08/25/2023 - Added new APIs under Business and Listing modules,
Get Category List API, Get GMB Attributes API & Get Timezone List
* 07/21/2023 - Added new API under Business module i.e, Business
Search API.
* 06/30/2023 - Added support for service area based information in
Get Business API and Update Business API.
* 10/04/2024 - Added support to fetch ticketId associated with the
survey responses in List Response API.
paths:
/v1/business/{businessId}:
put:
tags:
- Business
summary: Update Business
description: Update Business API updates business information.
operationId: updateBusiness
parameters:
- name: businessId
in: path
description: The Business Number
required: true
example: '12345678'
schema:
type: string
- name: Accept
in: header
description: e.g. application/json
required: false
example: application/json
schema:
type: string
default: application/json
- name: x-api-key
in: header
description: >-
e.g. [Required] Partner specific API key provided by Birdeye for
data exchange.
required: false
example: >-
[Required] Partner specific API key provided by Birdeye for data
exchange.
schema:
type: string
- name: Content-Type
in: header
description: Media type of the JSON request body.
required: false
example: application/json
schema:
type: string
default: application/json
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Apiary_updateBusiness_Request'
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
name:
type: string
alias:
type: string
emailId:
type: string
phone:
type: string
fax:
type: string
websiteUrl:
type: string
description:
type: string
keywords:
type: string
services:
type: string
logoUrl:
type: string
coverImageUrl:
type: string
gmbCover:
type: string
facebookCover:
type: string
timezone:
type: string
languages:
type: array
items:
type: string
isServiceAreaProvider:
type: string
serviceAreas:
type: array
items:
type: object
properties:
description:
type: string
placeId:
type: string
required:
- description
- placeId
payment:
type: string
hoursOfOperations:
type: array
items:
type: object
properties:
day:
type: string
isOpen:
type: number
workingHours:
type: array
items:
type: object
properties:
startHour:
type: string
endHour:
type: string
required:
- startHour
- endHour
comment:
type: string
required:
- day
- isOpen
- workingHours
- comment
working24x7:
type: number
location:
type: object
properties:
address1:
type: string
address2:
type: string
city:
type: string
state:
type: string
zip:
type: string
countryCode:
type: string
countryName:
type: string
categoryList:
type: array
items:
type: string
socialProfileURLs:
type: object
properties:
googleUrl:
type: string
facebookUrl:
nullable: true
twitterUrl:
nullable: true
linkedinUrl:
nullable: true
youTubeUrl:
nullable: true
example:
name: Dieci Lifestyle Spa
alias: Dieci Lifestyle Spa - Livingston, NJ
emailId: 4568@livelovespa.com
phone: (973) 716-0101
fax: (973) 716-0102
websiteUrl: http://www.diecispa.com/
description: >-
Specialties
Bridal ServicesMakeup: Makeovers/Lessons/ Faux Lash
applicationMassagesFacialsMicrocurrentMicrodermabrasionBody…
keywords: >-
Hair Salons,Day Spas,Beauty Salon,Beauty
Salons,Salons,Massage Therapists
services: Beauty Salon, Hair Spa
logoUrl: >-
http://d3cnqzq0ivprch.cloudfront.net/prod/css/images/logo.jpg
coverImageUrl: >-
http://d3cnqzq0ivprch.cloudfront.net/common/css/images/profile/spa.jpg
gmbCover: >-
http://d3cnqzq0ivprch.cloudfront.net/common/css/images/profile/abcd.jpg
facebookCover: >-
http://d3cnqzq0ivprch.cloudfront.net/common/css/images/profile/fb.jpg
timezone: Pacific Standard Time
languages:
- English
- Spanish
isServiceAreaProvider: 'Yes'
serviceAreas:
- description: 2390 Boston Street, Seattle, WA, 98109
placeId: ChIJ9YasdSKZs0wRSt--7QSjsd3
- description: 400 Boston Street, Seattle, WA, 98109
placeId: ChIJ9aasdAOKZasdaSt--7QsdLja4
payment: Visa, MasterCard, American Express, Debit Cards, Check
hoursOfOperations:
- day: '0'
isOpen: 1
workingHours:
- startHour: 32400
endHour: '13:30'
- startHour: '14:30'
endHour: '19:00'
comment: ''
- day: '1'
isOpen: 1
workingHours:
- startHour: 32400
endHour: '13:30'
- startHour: '14:30'
endHour: '19:00'
comment: ''
- day: '2'
isOpen: 1
workingHours:
- startHour: 32400
endHour: '13:30'
- startHour: '14:30'
endHour: '19:00'
comment: ''
- day: '3'
isOpen: 1
workingHours:
- startHour: 32400
endHour: '13:30'
- startHour: '14:30'
endHour: '19:00'
comment: ''
- day: '4'
isOpen: 1
workingHours:
- startHour: 32400
endHour: '13:30'
- startHour: '14:30'
endHour: '19:00'
comment: ''
- day: '5'
isOpen: 1
workingHours:
- startHour: 32400
endHour: '13:30'
- startHour: '14:30'
endHour: '19:00'
comment: ''
- day: '6'
isOpen: 0
working24x7: 0
location:
address1: 90 W Mount Pleasant Ave
address2: (btwn Preston Dr. & N. Mitchell Ave.)
city: Livingston
state: NJ
zip: '07039'
countryCode: US
countryName: United States of America
categoryList:
- Hair Salons
socialProfileURLs:
googleUrl: 'null'
facebookUrl: null
twitterUrl: null
linkedinUrl: null
youTubeUrl: null
example:
name: Dieci Lifestyle Spa
alias: Dieci Lifestyle Spa - Livingston, NJ
emailId: 4568@livelovespa.com
phone: (973) 716-0101
fax: (973) 716-0102
websiteUrl: http://www.diecispa.com/
description: >-
Specialties
Bridal ServicesMakeup: Makeovers/Lessons/ Faux Lash
applicationMassagesFacialsMicrocurrentMicrodermabrasionBody…
keywords: >-
Hair Salons,Day Spas,Beauty Salon,Beauty Salons,Salons,Massage
Therapists
services: Beauty Salon, Hair Spa
logoUrl: http://d3cnqzq0ivprch.cloudfront.net/prod/css/images/logo.jpg
coverImageUrl: >-
http://d3cnqzq0ivprch.cloudfront.net/common/css/images/profile/spa.jpg
gmbCover: >-
http://d3cnqzq0ivprch.cloudfront.net/common/css/images/profile/abcd.jpg
facebookCover: >-
http://d3cnqzq0ivprch.cloudfront.net/common/css/images/profile/fb.jpg
timezone: Pacific Standard Time
languages:
- English
- Spanish
isServiceAreaProvider: 'Yes'
serviceAreas:
- description: 2390 Boston Street, Seattle, WA, 98109
placeId: ChIJ9YasdSKZs0wRSt--7QSjsd3
- description: 400 Boston Street, Seattle, WA, 98109
placeId: ChIJ9aasdAOKZasdaSt--7QsdLja4
payment: Visa, MasterCard, American Express, Debit Cards, Check
hoursOfOperations:
- day: '0'
isOpen: 1
workingHours:
- startHour: '09:00'
endHour: '13:30'
- startHour: '14:30'
endHour: '19:00'
comment: ''
- day: '1'
isOpen: 1
workingHours:
- startHour: '09:00'
endHour: '13:30'
- startHour: '14:30'
endHour: '19:00'
comment: ''
- day: '2'
isOpen: 1
workingHours:
- startHour: '09:00'
endHour: '13:30'
- startHour: '14:30'
endHour: '19:00'
comment: ''
- day: '3'
isOpen: 1
workingHours:
- startHour: '09:00'
endHour: '13:30'
- startHour: '14:30'
endHour: '19:00'
comment: ''
- day: '4'
isOpen: 1
workingHours:
- startHour: '09:00'
endHour: '13:30'
- startHour: '14:30'
endHour: '19:00'
comment: ''
- day: '5'
isOpen: 1
workingHours:
- startHour: '09:00'
endHour: '13:30'
- startHour: '14:30'
endHour: '19:00'
comment: ''
- day: '6'
isOpen: 0
working24x7: 0
location:
address1: 90 W Mount Pleasant Ave
address2: (btwn Preston Dr. & N. Mitchell Ave.)
city: Livingston
state: NJ
zip: '07039'
countryCode: US
countryName: United States of America
categoryList:
- Hair Salons
socialProfileURLs:
googleUrl: 'null'
facebookUrl: null
twitterUrl: null
linkedinUrl: null
youTubeUrl: null
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/1045Model'
x-apiary-response-models:
- $ref: '#/components/schemas/1045Model'
- $ref: '#/components/schemas/2296Model'
- $ref: '#/components/schemas/2297Model'
- $ref: '#/components/schemas/2290Model'
- $ref: '#/components/schemas/3334Model'
- $ref: '#/components/schemas/3335Model'
- $ref: '#/components/schemas/3336Model'
- $ref: '#/components/schemas/3337Model'
- $ref: '#/components/schemas/3348Model'
- $ref: '#/components/schemas/2511Model'
- $ref: '#/components/schemas/2512Model'
- $ref: '#/components/schemas/2513Model'
- $ref: '#/components/schemas/2514Model'
- $ref: '#/components/schemas/2515Model'
- $ref: '#/components/schemas/2516Model'
- $ref: '#/components/schemas/2517Model'
- $ref: '#/components/schemas/2518Model'
- $ref: '#/components/schemas/2519Model'
- $ref: '#/components/schemas/2520Model'
- $ref: '#/components/schemas/6000Model'
- $ref: '#/components/schemas/6001Model'
x-apiary-response-examples:
error_1045:
value:
code: 1045
message: Business name cannot be blank
error_2296:
value:
code: 2296
message: Invalid Food Delivery link
error_2297:
value:
code: 2297
message: Invalid Food Takeout link
error_2290:
value:
code: 2290
message: >-
Food Takeout/Food Delivery not supported for gmb primary
category
error_3334:
value:
code: 2503
message: >-
Primary category can not be included in additional
category.
error_3335:
value:
code: 2276
message: Please add upto 9 GBP additional categories only.
error_3336:
value:
code: 2277
message: Duplicate GBP categories are not allowed.
error_3337:
value:
code: 2278
message: >-
Primary GBP category is not allowed in additional GBP
categories.
error_3348:
value:
code: 2162
message: Reopen date should not be less than current date.
error_2511:
value:
code: 2511
message: >-
Cannot update business status when listing is already
fixed.
error_2512:
value:
code: 2512
message: >-
Cannot update opening soon date when listing is already
fixed.
error_2513:
value:
code: 2513
message: Opened On date can not be in future.
error_2514:
value:
code: 2514
message: >-
Opening Soon date is mandatory when business is marked as
Opening soon.
error_2515:
value:
code: 2515
message: Reopen date is not supported for this date.
error_2516:
value:
code: 2516
message: Opening Soon Date can not be more than 1 year from now.
error_2517:
value:
code: 2517
message: Opening Soon date should not be less than current date.
error_2518:
value:
code: 2518
message: >-
Business Status is mandatory to pass with reopen, opened
on and opening soon date.
error_2519:
value:
code: 2519
message: >-
Third party categories change for opening soon business is
not allowed.
error_2520:
value:
code: 2520
message: Open Date is not supported for this date
error_6000:
value:
code: 6000
message: >-
The 'sub_locality' field is mandatory for addresses in New
Zealand.
error_6001:
value:
code: 6001
message: The 'sub_locality' field cannot exceed 80 characters.
examples:
response:
value:
code: 1045
message: Business name cannot be blank
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/1161Model'
x-apiary-response-models:
- $ref: '#/components/schemas/1161Model'
- $ref: '#/components/schemas/1167Model'
- $ref: '#/components/schemas/1047Model'
- $ref: '#/components/schemas/1046Model'
- $ref: '#/components/schemas/1055Model'
- $ref: '#/components/schemas/1056Model'
- $ref: '#/components/schemas/1069Model'
- $ref: '#/components/schemas/1070Model'
- $ref: '#/components/schemas/1190Model'
x-apiary-response-examples:
error_1161:
value:
code: 1161
message: Invalid API key
error_1167:
value:
code: 1167
message: API key is missing
error_1047:
value:
code: 1047
message: Business name cannot be less than 3 characters
error_1046:
value:
code: 1046
message: Business name cannot be more than 250 characters
error_1055:
value:
code: 1055
message: Not a valid US phone number.
error_1056:
value:
code: 1056
message: Not a valid US fax number.
error_1069:
value:
code: 1069
message: Business description cannot be more than 4000 characters.
error_1070:
value:
code: 1070
message: Business keywords cannot be more than 1000 characters.
error_1190:
value:
code: 1190
message: Invalid category
examples:
response:
value:
code: 1161
message: Invalid API key
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/1175Model'
examples:
response:
value:
code: 1175
message: No business found with the given id
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/89Model'
examples:
response:
value:
code: 89
message: Rate limit exceeded
components:
schemas:
Apiary_updateBusiness_Request:
type: object
properties:
name:
type: string
description: Name of the Business/Product (Max 250 character long).
alias:
type: string
description: Alias, Your internal way of identifying this location.
isAddressHidden:
type: number
description: >-
If your business doesn’t have a place for your customers to visit,
then you can hide your street address. 1 -> hide, 0 -> unhide (Note
that this isn’t supported by all sites).
location:
type: object
properties:
address1:
type: string
description: Address of the business/location.
address2:
type: string
description: Address of the business/location.
subLocality:
type: string
description: >-
(Char 4-80) Mandatory for: New Zealand (Enter the Suburb) Other
Countries: This field is not required. Any data entered here for
countries outside of New Zealand will be ignored by the system.
city:
type: string
description: City (Max 1000 character long).
state:
type: string
description: State (2 character state code).
countryCode:
type: string
description: Country Code (2 character country code).
zip:
type: string
description: Zip Code.
required:
- zip
description: Business address
emailId:
type: string
description: Business Email ID.
phone:
type: string
description: Business Phone (Required) Format is (xxx) xxx-xxxx.
fax:
type: string
description: Fax number Format is (xxx) xxx-xxxx.
websiteUrl:
type: string
description: Business website url.
establishedYear:
type: number
description: Year established
timezone:
type: string
description: Timezone of the business.
languages:
type: array
description: Language.
items: {}
isServiceAreaProvider:
type: string
description: >-
To select whether the business is Service Area Business Type.
Default value is : No.
serviceAreas:
type: array
description: >-
Service Area information. You can enter upto 10 service area
addresses in one request
items:
type: object
properties:
description:
type: string
description: 'For supported service areas, Possible formats:'
working24x7:
type: number
description: Whether business is 24x7 open or not (0-false, 1-true).
hoursOfOperations:
type: array
description: Working hours of business for each day.
items:
type: object
properties:
day:
type: number
description: 0(Monday), 1(Tuesday), 2(Wednesday) and so on.
workingHours:
type: array
items:
type: object
properties:
startHour:
type: string
description: Start hour 9:00 (9 AM), 18:00 (6 PM)
endHour:
type: string
description: End hour 9:00 (9 AM), 18:00 (6 PM)
description: Working hours of the business
isOpen:
type: number
description: 0 (Business closed today), 1 (open)
comment:
type: string
description: Add the special instruction.
specialHours:
type: array
description: Special hours of business.
items:
type: object
properties:
specialDate:
type: string
description: It should be "MM/DD/YYYY".
startHour:
type: string
description: Start hour 9:00 (9 AM), 18:00 (6 PM)
endHour:
type: string
description: End hour 9:00 (9 AM), 18:00 (6 PM)
isOpen:
type: number
description: 0(Business closed today), 1 (open)
businessStatus:
type: string
description: >-
The business status on the listing page can be set to Open,
Temporarily Closed, Permanently Closed, or Opening Soon. A Reopen
Date is mandatory for 'Temporarily Closed' and 'Opening Soon'
statuses, while optional for 'Open'.
reopenDate:
type: string
description: >-
Reopen Date is required for the 'Temporarily Closed' and 'Opening
Soon' statuses, and optional for 'Open.' The date must be in the
'MM/dd/yyyy' format.
services:
type: string
description: Services (Comma separated list of services offered; used for SEO).
keywords:
type: string
description: >-
Keywords about the business. Useful in SEO. Business keyword cannot
be more than 1000 characters.
products:
type: string
appointmentLink:
type: string
description: >-
Let customers book appointments by redirecting them to your
appointments page.
reservationLink:
type: string
description: >-
Let customers reserve tables by linking them to your reservations
page.
menuLink:
type: string
description: Show customers what you serve by linking them to your menu.
orderAheadLink:
type: string
description: >-
Let customers place delivery and pick-up orders by linking them to
your ordering page.
impressum:
type: string
description: >-
In certain countries (like Austria, Germany and Switzerland),
businesses may be required by law to include a statement of
ownership on their web presence.
payment:
type: string
description: Payment Type (Max 250 character long).
localPhoneNumber:
type: string
description: Local phone number.
tollFreePhoneNumber:
type: string
description: Tollfree number.
androidAppURL:
type: string
description: Android app url.
iosAppURL:
type: string
description: IOS app url.
logoUrl:
type: string
description: >-
Logo Image. Minimum 250 x 250px. Recommended: 720 X 720 px. 10 KB
min.
gmbLogoOptOut:
type: number
description: >-
Update profile photo on your google my business page.
(1-false,0-true).
fbLogoOptOut:
type: number
description: Update profile photo on your facebook profile. (1-false,0-true).
gmbCoverOptOut:
type: number
description: >-
Update cover photo on your google my business page.
(1-false,0-true).
fbCoverOptOut:
type: number
description: Update cover photo on your facebook profile. (1-false,0-true).
coverImageUrl:
type: string
description: >-
Cover image URL for business displayed on custom review site.
Format: JPG, JPEG, PNG. Minimum 1296 x 367px.
gmbCover:
type: string
description: Google Cover Image Url.
facebookCover:
type: string
description: Facebook Cover Image Url.
coverBusinessInfoLayout:
type: string
description: Show on your Birdeye profile. Possible value will be
covidInfo:
type: object
properties:
postDescription:
type: string
description: Post will be update on gmb & FB
covid19SupportLink:
type: string
description: Should be a valid covid19 support url
virtualCareLink:
type: string
description: Should be a valid url virtual care link
description: Provide covid related update in.
bingListing:
type: object
properties:
primaryCategoryBing:
type: string
description: Primary category of bing.
bingPhoneNumber:
type: string
description: >-
You can provide a phone number which will be pushed only to your
Bing listing site and will override the primary phone number
set.
categories:
type: string
description: You can add up to 3 categories.
bingDescription:
type: string
description: Bing description cannot be more than 4096 characters.
description: Provide bing data for listing purpose.
internalListing:
type: object
properties:
description:
type: string
description: Business description cannot be more than 5000 characters.
category:
type: string
description: Primary category of business.
subcategory:
type: string
description: You can add up to 3 subcategories.
displayCategory:
type: string
description: >-
Choose one of the category either from primary category or from
sub categories.
required:
- category
- subcategory
description: Provide data for microsite listing purpose.
facebookListing:
type: object
properties:
category:
type: string
description: You can add up to 3 categories.
facebookDescription:
type: string
description: Facebook description cannot be more than 255 characters.
facebookPhoneNumber:
type: string
description: >-
Phone number for facebook profile. This phone number will
override the main phone number on your Facebook business page
description: Provide data for facebook listing purpose.
gmbListing:
type: object
properties:
googleWebsiteUrl:
type: string
description: Website url will update on google listing.
googlePhoneNumber:
type: string
description: >-
You can provide a phone number which will be pushed only to your
google listing site and will override the primary phone number
set.
googleStoreId:
type: string
description: Store id for google.
primaryCategoryGmb:
type: string
description: Primary category of google.
additionalCategory:
type: string
description: You can add up to 9 subcategories.
googleDescription:
type: string
description: Google description cannot be more than 750 characters.
attributes:
type: object
properties: {}
description: >-
Google my business attributes are highly visible statements
about your business that appear on your Google My Business
listing. Supported attributes are
foodDelivery:
type: string
description: >-
Enter the redirect URL where customers can place delivery
orders.This field is applicable for hospitality business and is
category dependent.Example http://www.ubereats.com
foodTakeout:
type: string
description: >-
Enter the redirect URL where customers can place 'takeout' food
orders. This field is applicable for hospitality business and is
category dependent.Example : http://www.ubereats.com
description: Provide data for gmb listing purpose.
socialProfileURLs:
type: object
properties:
facebookUrl:
type: string
description: Facebook URL.
twitterUrl:
type: string
description: Business Twitter URL.
linkedInUrl:
type: string
description: Business LinkedId URL.
googleUrl:
type: string
description: Business Google URL.
youTubeUrl:
type: string
description: Business Youtube URL.
description: Profile URLs for business on top rated social sites
isSEOEnabled:
type: boolean
description: >-
Enable/Disbale search engine indexing of business profile. Valid
values are "true","false". Default is "true".
externalReferenceId:
type: string
description: It should be a unique value for location identifier.
customFields:
type: object
properties:
type:
type: string
description: Type of field.
fieldValue:
type: string
description: Custom field value.
fieldName:
type: string
description: >-
Name of custom field (Make sure to enter the same fieldName or
else the new field will be created).
id:
type: number
description: fieldId of the custom field created earlier.
required:
- fieldName
- id
description: Custom Field To be Updated
entityCategory:
type: string
description: >-
Specifies the category of the business entity being created or
updated. Valid values are:
required:
- emailId
- phone
- services
1045Model:
type: object
properties:
code:
type: number
message:
type: string
example:
code: 1045
message: Business name cannot be blank
1161Model:
type: object
properties:
code:
type: number
message:
type: string
example:
code: 1161
message: Invalid API key
1175Model:
type: object
properties:
code:
type: number
message:
type: string
example:
code: 1175
message: No business found with the given id
89Model:
type: object
properties:
code:
type: number
message:
type: string
example:
code: 89
message: Rate limit exceeded
````