---
title: "Claim an Advertiser ID; idempotent for the owning company"
method: POST
path: "/walmart/advertisers"
tags: ["walmart"]
---

# Claim an Advertiser ID; idempotent for the owning company

`POST /walmart/advertisers`

## Request

- Base URL: `https://api.autron.ai`
- URL: `https://api.autron.ai/walmart/advertisers`
- Auth: API key in header `Authorization`

## Query parameters

- `advertiser_id` string, required
- `advertiser_name` string

## Response `200`

Success

- WalmartAdvertiser
  - `public_id` string: unique walmart advertiser public id
  - `walmart_seller_public_id` string: public id of the company's Walmart root
  - `advertiser_id` string: Walmart Advertiser ID as shown in Ad Center (Admin > Advertiser)
  - `advertiser_name` string: customer-entered label, optional
  - `advertiser_type` string: '3p' / '1p' from the Advertiser Attributes report; null until synced
  - `permission_type` string: partner permission from the access report (campaign_management / reporting_only); null until synced
  - `access_status` string: pending (claimed, not yet granted) | active (a signed call returned 200) | revoked (was active, now 'do not have access')
  - `claimed_at` string, date-time: when the customer claimed the id
  - `confirmed_at` string, date-time: when a probe first returned 200
  - `last_probe_at` string, date-time: last signed probe for this advertiser
  - `last_probe_status` string: ok | not_granted | http_<status> | transport_error
  - `last_error` string: body / error excerpt of the last failed probe
  - `report_date` string, date: reportDate of the Advertiser Attributes report row this advertiser was last seen in; null until synced
  - `daily_spend_ceiling` number, nullable: dollars per day above which the agent asks the seller first; null when none is agreed. Stored only: nothing enforces it

## Other responses

- `201`: Advertiser claimed (pending until Walmart grants access).
- `409`: Advertiser ID already connected to another company.

---

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