Skip to main content

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​

AttributeDescriptionRequiredPossible Values
organization_idOrganization IDR
nameName of the Billing CenterR
email_addressEmail addressR
address_line_1Address line 1R
localityLocalityR
administrative_district_level_1DistrictR
countryCountryR
postal_codePost codeR
alternative_email_addressesArray of email addressesO

Get all Billing Centers​

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

HTTP Request​

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

Parameters​

ParameterDefaultDescription
organization_idOrganization ID

Example - Retrieving 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"]
      }
    }
  ]
}

Get a specific Billing Center​

The following API request retrieves a specific Billing Center.

HTTP Request​

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

Parameters​

ParameterDefaultDescription
billing_center_idBilling Center ID

Example - Retrieving 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"]
      }
    }
  ]
}

Create a Billing Center​

The following API request creates a new Billing Center.

HTTP Request​

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

Parameters​

ParameterDefaultDescription
billing_center_idBilling Center ID

Example - Creating 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"]
      }
    }
  ]
}

Update a Billing Center​

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

Attributes that can be updated​

AttributeRequired
nameR
email_addressR
address_line_1R
localityR
administrative_district_level_1R
countryR
postal_codeR
alternative_email_addressesO

HTTP Request​

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

Parameters​

ParameterDefaultDescription
billing_center_idBilling Center ID

Example - Updating a Billing Center​

curl -X PUT \
  -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"
        ]
      }
    }
  ]
}
Was this page helpful?
Yes
No