Skip to main content
POST
/
v0
/
pages
/
{page_id}
/
audiences
Create audience
curl --request POST \
  --url https://api.tryarchitect.com/v0/pages/{page_id}/audiences \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "publishBehavior": "publish",
  "actionFormIdOverride": "<string>",
  "actionFormInstructionsOverride": "<string>",
  "actionUrlOverride": "<string>",
  "customName": "<string>",
  "metadataOverride": {
    "title": "<string>",
    "description": "<string>",
    "keywords": [
      "<string>"
    ],
    "author": "<string>",
    "robots": [],
    "canonicalUrl": "<string>",
    "ogTitle": "<string>",
    "ogDescription": "<string>",
    "ogImageAlt": "<string>",
    "ogSiteName": "<string>",
    "ogUrl": "<string>",
    "twitterTitle": "<string>",
    "twitterDescription": "<string>",
    "twitterImageAlt": "<string>",
    "twitterSite": "<string>",
    "twitterCreator": "<string>",
    "themeColor": "<string>"
  },
  "supplementaryContext": "<string>"
}
'
{
  "actionFormIdOverride": "<string>",
  "actionFormInstructionsOverride": "<string>",
  "actionUrlOverride": "<string>",
  "archivedAt": "<string>",
  "audienceId": "<string>",
  "computedName": "<string>",
  "createdAt": "<string>",
  "customName": "<string>",
  "effectiveName": "<string>",
  "flags": [],
  "isNewPageAgent": true,
  "latestVersion": {
    "archivedAt": "<string>",
    "audienceId": "<string>",
    "becameDraftAt": "<string>",
    "cancelledAt": "<string>",
    "createdAt": "<string>",
    "isNewPageAgent": true,
    "obsoleteAt": "<string>",
    "publishedAt": "<string>",
    "queueDurationMs": 123,
    "queuedAt": "<string>",
    "supplementaryContext": "<string>",
    "versionId": "<string>",
    "versionNumber": 123
  },
  "pageId": "<string>",
  "personId": "<string>",
  "personRouteKey": "<string>",
  "publishedVersion": {
    "archivedAt": "<string>",
    "audienceId": "<string>",
    "becameDraftAt": "<string>",
    "cancelledAt": "<string>",
    "createdAt": "<string>",
    "isNewPageAgent": true,
    "obsoleteAt": "<string>",
    "publishedAt": "<string>",
    "queueDurationMs": 123,
    "queuedAt": "<string>",
    "supplementaryContext": "<string>",
    "versionId": "<string>",
    "versionNumber": 123
  },
  "supplementaryContext": "<string>",
  "effectiveMetadata": {
    "title": "<string>",
    "description": "<string>",
    "keywords": [
      "<string>"
    ],
    "author": "<string>",
    "robots": [],
    "canonicalUrl": "<string>",
    "ogTitle": "<string>",
    "ogDescription": "<string>",
    "ogImageUrl": "<string>",
    "ogImageFileId": "<string>",
    "ogImageAlt": "<string>",
    "ogSiteName": "<string>",
    "ogUrl": "<string>",
    "twitterTitle": "<string>",
    "twitterDescription": "<string>",
    "twitterImageUrl": "<string>",
    "twitterImageFileId": "<string>",
    "twitterImageAlt": "<string>",
    "twitterSite": "<string>",
    "twitterCreator": "<string>",
    "themeColor": "<string>"
  },
  "metadataOverride": {
    "title": "<string>",
    "description": "<string>",
    "keywords": [
      "<string>"
    ],
    "author": "<string>",
    "robots": [],
    "canonicalUrl": "<string>",
    "ogTitle": "<string>",
    "ogDescription": "<string>",
    "ogImageUrl": "<string>",
    "ogImageFileId": "<string>",
    "ogImageAlt": "<string>",
    "ogSiteName": "<string>",
    "ogUrl": "<string>",
    "twitterTitle": "<string>",
    "twitterDescription": "<string>",
    "twitterImageUrl": "<string>",
    "twitterImageFileId": "<string>",
    "twitterImageAlt": "<string>",
    "twitterSite": "<string>",
    "twitterCreator": "<string>",
    "themeColor": "<string>"
  }
}

Authorizations

​
x-api-key
string
header
required

API key authentication for the External Actor Gateway

Path Parameters

​
page_id
string
required

page_id parameter

Body

application/json
​
publishBehavior
enum<string>
default:publish
required
Available options:
draft,
publish
​
actionFormIdOverride
string
​
actionFormInstructionsOverride
string
​
actionUrlOverride
string<uri>

URL to open when action is triggered

​
customName
string
Minimum string length: 1
​
metadataOverride
object
​
supplementaryContext
string
Minimum string length: 1

Response

Audience created successfully

​
actionFormIdOverride
string | null
required
​
actionFormInstructionsOverride
string | null
required
​
actionUrlOverride
string | null
required
​
archivedAt
string | null
required
Pattern: ^\+[1-9]\d{1,14}$
​
audienceId
string
required
​
computedName
string
required
​
createdAt
string
required
Pattern: ^\+[1-9]\d{1,14}$
​
customName
string | null
required
​
effectiveName
string
required
​
flags
enum<string>[]
required
Available options:
home_page
​
isNewPageAgent
boolean
required
​
latestVersion
object
required
​
pageId
string
required
​
personId
string | null
required
​
personRouteKey
string | null
required
​
publishedVersion
object
required
​
status
enum<string>
required
Available options:
archived,
cancelled,
draft,
pending,
processing,
published,
queued
​
supplementaryContext
string | null
required
​
effectiveMetadata
object
​
metadataOverride
object