Update billing info

PUT /api/v2/billing/info Updates the billing (payer) info Scope3 invoices you with. Admin-only. Send at least one field; omitted fields are left unchanged. The response returns the full updated record. At minimum, Scope3 needs a payer name (contactName) and a payer address (address, city, countryAlpha2) to issue an invoice — set both before your first billing cycle. Also available in the UI under Settings → Billing.

Request

curl

curl -X PUT https://api.interchange.io/api/v2/billing/info \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contactName": "Dana Whitfield",
    "email": ["ap@bluepeakbrands.example"],
    "ccEmails": ["finance@bluepeakbrands.example"],
    "phone": "+1 415 555 0182",
    "address": "225 Mission St",
    "address2": "Floor 8",
    "city": "San Francisco",
    "region": "CA",
    "postalCode": "94105",
    "countryAlpha2": "US",
    "taxId": "83-1234567"
  }'

Parameters

Field	Type	Required	Notes
`contactName`	string	No*	Billing contact / payer name (1–255). *Needed before an invoice can be issued
`email`	array	No	Up to 10 email addresses invoices are sent to
`ccEmails`	array	No	Up to 10 email addresses CC’d on invoices
`phone`	string	No	Billing phone number (max 64)
`address`	string	No*	Billing street address, line 1 (max 255). *Needed before an invoice can be issued
`address2`	string	No	Billing street address, line 2 (max 255)
`city`	string	No	Billing city (max 128)
`region`	string	No	State/province/region (max 128)
`postalCode`	string	No	Postal/ZIP code (max 32)
`countryAlpha2`	string	No	ISO 3166-1 alpha-2, uppercase (e.g. `US`)
`taxId`	string	No	Tax/VAT identifier shown on invoices (max 64)

Response

{
  "billingInfo": {
    "contactName": "Dana Whitfield",
    "email": ["ap@bluepeakbrands.example"],
    "ccEmails": ["finance@bluepeakbrands.example"],
    "phone": "+1 415 555 0182",
    "address": "225 Mission St",
    "address2": "Floor 8",
    "city": "San Francisco",
    "region": "CA",
    "postalCode": "94105",
    "countryAlpha2": "US",
    "taxId": "83-1234567"
  }
}

The response mirrors Get billing info after the update.

Errors

400 VALIDATION_ERROR — a malformed email in email/ccEmails, a lowercase or non-ISO countryAlpha2, or an empty body (at least one field is required).
401 UNAUTHORIZED — missing or invalid bearer token.
403 FORBIDDEN — the caller is not an admin of the account.

See Errors for the full error contract.

Get billing info

Read the details on file

Billing overview

How invoicing and remittance work

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Request

Parameters

Response

Errors

Get billing info

Billing overview

​Request

​Parameters

​Response

​Errors

​Related

Get billing info

Billing overview

Request

Parameters

Response

Errors

Related