> ## Documentation Index
> Fetch the complete documentation index at: https://docs.targeter.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Publisher integrations

> Ideal API contract for platforms Targeter creates ads on and fetches insights from

## What this is

Targeter’s partner API (under **API**) is how external systems call Targeter.

This section is the other direction: how **Targeter calls your API**. It is the ideal contract for publishers, media houses, and ad platforms that Targeter creates ads on and pulls reporting from.

If you implement these endpoints, Targeter can onboard your inventory without a custom adapter for every function.

## Base URL

All requests are made to the host you provide during setup:

```
https://{publisher_host}/v1
```

Use snake\_case JSON, UTC ISO 8601 timestamps for ad flights, `YYYY-MM-DD` for insight windows, and ISO 4217 currency codes.

## Authentication

Targeter sends a token you issue during [integration setup](/integrations/setup):

```
Authorization: Bearer <token>
```

## Ideal functions

Targeter expects this set of operations. Implement all of them unless a function is marked optional during onboarding.

<AccordionGroup>
  <Accordion title="Offices" icon="building">
    * **[Create office](/integrations/offices/create)** — create a broker/advertiser office; you generate `office_id`
    * **[Get office ID](/integrations/offices/get)** — resolve an existing office to its `office_id`
  </Accordion>

  <Accordion title="Ads" icon="rectangle-ad">
    * **[Create ad](/integrations/ads/create)** — create an ad under a Targeter campaign
    * **[Update ad](/integrations/ads/update)** — change budget, dates, targeting, creatives, or platforms
    * **[Delete ad](/integrations/ads/delete)** — permanently remove an ad
    * **[Pause ad](/integrations/ads/pause)** — stop delivery without deleting
    * **[Resume ad](/integrations/ads/resume)** — restart a paused ad
    * **[Get ad status](/integrations/ads/status)** — return current delivery status
  </Accordion>

  <Accordion title="Insights and platforms" icon="chart-line">
    * **[Fetch insight](/integrations/insights/fetch)** — return performance metrics for an ad
    * **[Get publisher platforms](/integrations/platforms/get)** — list channels Targeter may request
  </Accordion>
</AccordionGroup>

## Typical flow

```mermaid theme={null}
sequenceDiagram
    participant T as Targeter
    participant P as Publisher API

    T->>P: GET /publisher-platforms
    P-->>T: available channels
    T->>P: GET /offices?name=Torshov
    alt office missing
        T->>P: POST /offices
        P-->>T: office_id
    else office exists
        P-->>T: office_id
    end
    T->>P: POST /ads
    P-->>T: ad_id + status
    loop while the campaign is live
        T->>P: GET /ads/{ad_id}/status
        T->>P: GET /ads/{ad_id}/insights
    end
    T->>P: POST /ads/{ad_id}/pause
```

## Errors

Match Targeter’s partner API: HTTP status codes plus a JSON body.

```json theme={null}
{
    "error": "Invalid request payload",
    "details": [
        {
            "path": ["material", "target_url"],
            "message": "Target URL is required"
        }
    ]
}
```

Use **401** for missing or invalid tokens, **404** when an office or ad does not exist, and **409** when the current ad status does not allow the requested action.