Create Business

Create a business

curl --request POST \
  --url https://api.birdeye.com/resources/v1/signup/reseller/subaccount \
  --header 'Content-Type: application/json' \
  --data '
{
  "businessName": "The Business Name",
  "zip": 32323,
  "type": "Business",
  "phone": "4032365164",
  "entityCategory": "physical_location",
  "countryCode": "US",
  "aggrOptions": 1
}
'

import requests

url = "https://api.birdeye.com/resources/v1/signup/reseller/subaccount"

payload = {
    "businessName": "The Business Name",
    "zip": 32323,
    "type": "Business",
    "phone": "4032365164",
    "entityCategory": "physical_location",
    "countryCode": "US",
    "aggrOptions": 1
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    businessName: 'The Business Name',
    zip: 32323,
    type: 'Business',
    phone: '4032365164',
    entityCategory: 'physical_location',
    countryCode: 'US',
    aggrOptions: 1
  })
};

fetch('https://api.birdeye.com/resources/v1/signup/reseller/subaccount', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.birdeye.com/resources/v1/signup/reseller/subaccount",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'businessName' => 'The Business Name',
    'zip' => 32323,
    'type' => 'Business',
    'phone' => '4032365164',
    'entityCategory' => 'physical_location',
    'countryCode' => 'US',
    'aggrOptions' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.birdeye.com/resources/v1/signup/reseller/subaccount"

	payload := strings.NewReader("{\n  \"businessName\": \"The Business Name\",\n  \"zip\": 32323,\n  \"type\": \"Business\",\n  \"phone\": \"4032365164\",\n  \"entityCategory\": \"physical_location\",\n  \"countryCode\": \"US\",\n  \"aggrOptions\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.birdeye.com/resources/v1/signup/reseller/subaccount")
  .header("Content-Type", "application/json")
  .body("{\n  \"businessName\": \"The Business Name\",\n  \"zip\": 32323,\n  \"type\": \"Business\",\n  \"phone\": \"4032365164\",\n  \"entityCategory\": \"physical_location\",\n  \"countryCode\": \"US\",\n  \"aggrOptions\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.birdeye.com/resources/v1/signup/reseller/subaccount")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"businessName\": \"The Business Name\",\n  \"zip\": 32323,\n  \"type\": \"Business\",\n  \"phone\": \"4032365164\",\n  \"entityCategory\": \"physical_location\",\n  \"countryCode\": \"US\",\n  \"aggrOptions\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "businessId": 653356544
}

{
  "code": 2166,
  "message": "Invalid Business Type"
}

{
  "code": 1033,
  "message": "You are not authorized to perform this action"
}

{
  "code": 1010,
  "message": "No user found with the given id"
}

{
  "code": 89,
  "message": "Rate limit exceeded"
}

POST

signup

reseller

subaccount

Create a business

curl --request POST \
  --url https://api.birdeye.com/resources/v1/signup/reseller/subaccount \
  --header 'Content-Type: application/json' \
  --data '
{
  "businessName": "The Business Name",
  "zip": 32323,
  "type": "Business",
  "phone": "4032365164",
  "entityCategory": "physical_location",
  "countryCode": "US",
  "aggrOptions": 1
}
'

import requests

url = "https://api.birdeye.com/resources/v1/signup/reseller/subaccount"

payload = {
    "businessName": "The Business Name",
    "zip": 32323,
    "type": "Business",
    "phone": "4032365164",
    "entityCategory": "physical_location",
    "countryCode": "US",
    "aggrOptions": 1
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    businessName: 'The Business Name',
    zip: 32323,
    type: 'Business',
    phone: '4032365164',
    entityCategory: 'physical_location',
    countryCode: 'US',
    aggrOptions: 1
  })
};

fetch('https://api.birdeye.com/resources/v1/signup/reseller/subaccount', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.birdeye.com/resources/v1/signup/reseller/subaccount",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'businessName' => 'The Business Name',
    'zip' => 32323,
    'type' => 'Business',
    'phone' => '4032365164',
    'entityCategory' => 'physical_location',
    'countryCode' => 'US',
    'aggrOptions' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.birdeye.com/resources/v1/signup/reseller/subaccount"

	payload := strings.NewReader("{\n  \"businessName\": \"The Business Name\",\n  \"zip\": 32323,\n  \"type\": \"Business\",\n  \"phone\": \"4032365164\",\n  \"entityCategory\": \"physical_location\",\n  \"countryCode\": \"US\",\n  \"aggrOptions\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.birdeye.com/resources/v1/signup/reseller/subaccount")
  .header("Content-Type", "application/json")
  .body("{\n  \"businessName\": \"The Business Name\",\n  \"zip\": 32323,\n  \"type\": \"Business\",\n  \"phone\": \"4032365164\",\n  \"entityCategory\": \"physical_location\",\n  \"countryCode\": \"US\",\n  \"aggrOptions\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.birdeye.com/resources/v1/signup/reseller/subaccount")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"businessName\": \"The Business Name\",\n  \"zip\": 32323,\n  \"type\": \"Business\",\n  \"phone\": \"4032365164\",\n  \"entityCategory\": \"physical_location\",\n  \"countryCode\": \"US\",\n  \"aggrOptions\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "businessId": 653356544
}

{
  "code": 2166,
  "message": "Invalid Business Type"
}

{
  "code": 1033,
  "message": "You are not authorized to perform this action"
}

{
  "code": 1010,
  "message": "No user found with the given id"
}

{
  "code": 89,
  "message": "Rate limit exceeded"
}

Headers

string

e.g. application/json

x-api-key

string

e.g. [Required] Partner specific API key provided by Birdeye for data exchange.

Query Parameters

rid

number

required

Id of the Reseller.

email_id

string

required

Business Email id.

Body

application/json

businessName

string

required

Name of the Business that needs to be added

zip

string

required

Postal code of the business location

phone

number

required

Phone number of the Business.

type

string

Type of the Business. Valid values are

Business,
Enterprise-Location,
Enterprise-Product,
Reseller
or a existing custom hierarchy type. Default is: Business.

entityCategory

string

Specifies the category of the business entity being created or updated. Valid values are:

physical_location,provider. physical_location represents a physical office, branch, or storefront location. provider represents an individual practitioner or provider (e.g. doctor, dentist, loan officer) operating within one or more physical locations. If entityCategory is not provided, the entity is created as physical_location by default.

countryCode

string

This field is mandatory for non US locations.

aggrOptions

number

Aggregation Options to enable/disable aggregations. Possible values are [0,1]

0 to Disable Search Business
1 to Enable Search Business,

If aggrOptions is not provided, then Search Business is enabled.

Response

businessId

number

Id of the created business

Overview

Business

Custom Fields

User

Reviews

Contact

Contact V2

Campaign

Aggregation

Report

Survey

Business Media

Social

Employee

Conversation

Subscription

Webhook

Competitor

Competitor AI

Insight AI

Google Q&A

Google Services

FAQ

Listing

GMB Products

Search AI

Ticketing

Integration

Headers

Query Parameters

Body

Response