---
title: "Record metadata-only OAuth/ETL state"
method: POST
path: "/oauth-etl-metadata"
---

# Record metadata-only OAuth/ETL state

`POST /oauth-etl-metadata`

## Request

- Base URL: `https://api.gravityads.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gravityads.dev/oauth-etl-metadata`
- Auth: HTTP bearer

Connector/data-plane ingestion endpoint. It records connection/account/ETL-run metadata in Ads Quant and never accepts raw tokens or writes ad platforms.

## Request body

- object
  - `request_id` string, required
  - `operator` string
  - `operator_id` string
  - `confirmation` string
  - `mode` string
  - `refresh_bootstrap` boolean
  - `records` object[], required
    - `tenant_id` string
    - `tenant_id_hash` string
    - `platform` string
    - `connection_id` string
    - `authorized_user_hash` string
    - `scopes` string[]
    - `oauth_status` string
    - `token_status` string
    - `refresh_status` string
    - `secret_ref_present` boolean
    - `last_successful_read_at` string
    - `accounts` object[]
    - `etl_runs` object[]

## Response `200`

Metadata result

- object

---

[API](https://skmtc.dev/gravityads/apis/gravityads-api.md) · [All operations](https://skmtc.dev/gravityads/apis/gravityads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gravityads/apis/gravityads-api/revisions/124cd07d534d?raw)