Skip to main content
POST
Create office

Overview

Create an office in the publisher system so ads can be attributed and billed correctly. You generate office_id. Targeter stores that id and sends it on later ad calls. If an office with the same name already exists, return 200 with the existing office instead of creating a duplicate.

Request

Headers

  • Authorization: Bearer {token} (required)
  • Content-Type: application/json

Body Parameters

string
required
Office display name as used in Targeter (for example a brokerage office)

Example Request

Response

Success (201 — new office)

string
Publisher-generated office id
string
Office display name

Success (200 — existing office)

Same body as 201 when name already exists.

Error Responses

400 - Invalid request payload

401 - Unauthorized

500 - Server Error

Authorizations

Authorization
string
header
required

API token issued to Targeter during integration setup. Send as Authorization: Bearer <token>.

Body

application/json
name
string
required

Office display name as used in Targeter

Example:

"Torshov"

Response

Office already exists for the given name

office_id
string
required

Publisher-generated office id

Example:

"off_8k2mQx"

name
string
required

Office display name

Example:

"Torshov"