Skip to main content
POST
/
provider
/
markets
Create a market
curl --request POST \
  --url https://api.offergrid.io/provider/markets \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "Austin Metro",
  "description": "Fiber footprint across Travis and Williamson counties.",
  "status": "draft",
  "tags": [
    "fiber",
    "priority"
  ]
}
'

Authorizations

​
x-api-key
string
header
required

Team API key for authentication. Your team role (provider/reseller/hybrid) determines which endpoints you can access.

Body

application/json
​
name
string
required

Provider-facing market name. Unique per provider team.

Example:

"Austin Metro"

​
description
string

Optional description of the market.

Example:

"Fiber footprint across Travis and Williamson counties."

​
status
enum<string>
default:draft

Lifecycle status.

Available options:
draft,
active,
paused,
archived
​
tags
string[]

Free-form tags for grouping markets.

Example:
["fiber", "priority"]

Response

201 - undefined