Billing Centers

Billing Centers allow Businesses to have multiple invoicing locations to choose from. A Billing Center is the contact that will be receiving invoices.

Billing Centers can only be created via Snap Business Manager.

Attributes

Attribute	Description	Required	Possible Values
organization_id	Organization ID	R
name	Name of the Billing Center	R
email_address	Email address	R
address_line_1	Address line 1	R
locality	Locality	R
administrative_district_level_1	District	R
country	Country	R
postal_code	Post code	R
alternative_email_addresses	Array of email addresses	O

Get all Billing Centers

curl "https://adsapi.snapchat.com/v1/organizations/8fdeefec-f502-4ca8-9a84-6411e0a51053/billingcenters" \
  -H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5eaa971a00ff05c3d6fabff7fb0001737e616473617069736300016275696c642d63386238336332372d312d3334372d310001011a",
  "paging": {},
  "billingcenters": [
    {
      "sub_request_status": "SUCCESS",
      "billingcenter": {
        "id": "8b8db2a8-2b48-42f0-858a-88901a782b27",
        "updated_at": "2017-10-17T12:25:50.866Z",
        "created_at": "2017-10-17T12:25:50.866Z",
        "organization_id": "8fdeefec-f502-4ca8-9a84-6411e0a51053",
        "name": "Duck Billing Center",
        "email_address": "mr_duck@example.com",
        "address_line_1": "11 Duck Pond Avenue",
        "locality": "London",
        "administrative_district_level_1": "GB-LND",
        "country": "GB",
        "postal_code": "NW1 4RY"
      }
    },
    {
      "sub_request_status": "SUCCESS",
      "billingcenter": {
        "id": "6e0f4532-3702-4f0b-9889-9fe5d0614afd",
        "updated_at": "2020-02-30T09:49:52.118Z",
        "created_at": "2020-02-30T09:49:52.118Z",
        "organization_id": "8fdeefec-f502-4ca8-9a84-6411e0a51053",
        "name": "Kianjous Billing Center",
        "email_address": "honeybear_ltd@example.com",
        "address_line_1": "10 Honey Bear Road",
        "locality": "London",
        "administrative_district_level_1": "GB-LND",
        "country": "GB",
        "postal_code": "NW1 4RY",
        "alternative_email_addresses": ["honeybear_burrow@example.com"]
      }
    }
  ]
}

The following API request retrieves all Billing Centers for an Organization.

HTTP Request

GET https://adsapi.snapchat.com/v1/organizations/{organization_id}/billingcenters

Parameters

Parameter	Default	Description
organization_id		Organization ID

Get a specific Billing Center

curl "https://adsapi.snapchat.com/v1/billingcenters/6e0f4532-3702-4f0b-9889-9fe5d0614afd" \
  -H "Authorization: Bearer meowmeowmeow"

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5eaa9e6000ff0570e6188bd1110001737e616473617069736300016275696c642d63386238336332372d312d3334372d3100010138",
  "billingcenters": [
    {
      "sub_request_status": "SUCCESS",
      "billingcenter": {
        "id": "6e0f4532-3702-4f0b-9889-9fe5d0614afd",
        "updated_at": "2020-02-30T09:49:52.118Z",
        "created_at": "2020-02-30T09:49:52.118Z",
        "organization_id": "8fdeefec-f502-4ca8-9a84-6411e0a51053",
        "name": "Kianjous Billing Center",
        "email_address": "honeybear_ltd@example.com",
        "address_line_1": "10 Honey Bear Road",
        "locality": "London",
        "administrative_district_level_1": "GB-LND",
        "country": "GB",
        "postal_code": "NW1 4RY",
        "alternative_email_addresses": ["honeybear_burrow@example.com"]
      }
    }
  ]
}

The following API request retrieves a specific Billing Center.

HTTP Request

GET https://adsapi.snapchat.com/v1/billingcenters/{billing_center_id}

Parameters

Parameter	Default	Description
billing_center_id		Billing Center ID

Create a Billing Center

curl -X POST \
  -d '{"billingcenters":[{"organization_id":"8fdeefec-f502-4ca8-9a84-6411e0a51053","name":"Kianjous Billing Center","email_address":"honeybear_ltd@example.com","address_line_1":"10 Honey Bear Road","locality":"London","administrative_district_level_1":"GB-LND","country":"GB","postal_code":"NW1 4RY","alternative_email_addresses":["honeybear_burrow@example.com"]}]}' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer meowmeowmeow" \
  https://adsapi.snapchat.com/v1/organizations/8fdeefec-f502-4ca8-9a84-6411e0a51053/billingcenters

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5eaa9f3f00ff0e03450355dbc60001737e616473617069736300016275696c642d63386238336332372d312d3334372d310001010b",
  "billingcenters": [
    {
      "sub_request_status": "SUCCESS",
      "billingcenter": {
        "id": "6e0f4532-3702-4f0b-9889-9fe5d0614afd",
        "updated_at": "2020-02-30T09:49:52.118Z",
        "created_at": "2020-02-30T09:49:52.118Z",
        "organization_id": "8fdeefec-f502-4ca8-9a84-6411e0a51053",
        "name": "Kianjous Billing Center",
        "email_address": "honeybear_ltd@example.com",
        "address_line_1": "10 Honey Bear Road",
        "locality": "London",
        "administrative_district_level_1": "GB-LND",
        "country": "GB",
        "postal_code": "NW1 4RY",
        "alternative_email_addresses": ["honeybear_burrow@example.com"]
      }
    }
  ]
}

The following API request creates a new Billing Center.

HTTP Request

POST https://adsapi.snapchat.com/v1/organizations/{organization_id}/billingcenters

Parameters

Parameter	Default	Description
billing_center_id		Billing Center ID

Update a Billing Center

curl -X POST \
  -H "Authorization: Bearer meowmeowmeow" \
  -H "Content-Type: application/json" \
  -d '{"billingcenters":[{"id":"6e0f4532-3702-4f0b-9889-9fe5d0614afd","organization_id":"1fdeefec-f502-4ca8-9a84-6411e0a51053","name":"Kianjous Billing Center","email_address":"honeybear_ltd@example.com","address_line_1":"10 Honey Bear Road","locality":"London","administrative_district_level_1":"GB-LND","country":"GB","postal_code":"NW1 4RY","alternative_email_addresses":["honeybear_burrow@example.com","mr_duck@example.com"]}]}'
  https://adsapi.snapchat.com/v1/organizations/8fdeefec-f502-4ca8-9a84-6411e0a51053/billingcenters

The above command returns JSON structured like this:

{
  "request_status": "SUCCESS",
  "request_id": "5eac190700ff04ae16ca53679d0001737e616473617069736300016275696c642d38653566343030352d312d3334382d3000010107",
  "billingcenters": [
    {
      "sub_request_status": "SUCCESS",
      "billingcenter": {
        "id": "6e0f4532-3702-4f0b-9889-9fe5d0614afd",
        "updated_at": "2020-05-01T12:41:43.470Z",
        "created_at": "2020-04-30T09:49:52.118Z",
        "organization_id": "8fdeefec-f502-4ca8-9a84-6411e0a51053",
        "name": "Kianjous Billing Center",
        "email_address": "honeybear_ltd@example.com",
        "address_line_1": "10 Honey Bear Road",
        "locality": "London",
        "administrative_district_level_1": "GB-LND",
        "country": "GB",
        "postal_code": "NW1 4RY",
        "alternative_email_addresses": [
          "honeybear_burrow@example.com",
          "mr_duck@example.com"
        ]
      }
    }
  ]
}

The following API request updates a Billing Center with new details.

IMPORTANT! The API expects the entire object when updating any fields. Omitting attributes that have default values will reset those attributes to the default.

Attributes that can be updated

Attribute	Required
name	R
email_address	R
address_line_1	R
locality	R
administrative_district_level_1	R
country	R
postal_code	R
alternative_email_addresses	O

HTTP Request

PUT https://adsapi.snapchat.com/v1/organizations/{organization_id}/billingcenters

Parameters

Parameter	Default	Description
billing_center_id		Billing Center ID