p202 text-ad create

Create a new text-ad

Writessupports --staged
All commands

p202 CLI reference

Back to the docs

01Run it

Straight from the command's own help.

p202 text-ad create --text-ad-name <text_ad_name> --text-ad-headline <text_ad_headline> --text-ad-description <text_ad_description> --text-ad-display-url <text_ad_display_url> --json

02What you get

Pick the shape you need. People get a table. Add --json, --csv or --ndjson for scripts, or -q for ids only. An AI agent gets compact JSON without asking. All output formats

03Build your command

Pick values and the command line writes itself, quoted and ready to paste.

p202 text-ad create

Set flags below; the command updates as you type.

04Flags

8 flags, plus the global flags every command takes.

FlagWhat it does
--aff-campaign-idstringCampaign ID (from p202 campaign list)
--idempotency-keystringRetry-safe create: the server records the response under this key and replays it on a retry with the same key and payload instead of creating a duplicate
--landing-page-idstringLanding page ID (from p202 landing-page list)
--text-ad-descriptionstringrequiredDescription text (required)
--text-ad-display-urlstringrequiredDisplay URL (required)
--text-ad-headlinestringrequiredHeadline (required)
--text-ad-namestringrequiredText ad name (required)
--text-ad-typestringText ad type (integer)

05For agents

Running this from an agent

  • Read the same facts as JSON: p202 commands text-ad create --json.
  • With AI_AGENT, CLAUDECODE or another agent variable set, output is compact JSON and errors arrive on stderr as a JSON envelope with a hint.
  • Exit codes: 0 ok, 1 bad input, 2 auth, 3 network, 4 server error, 5 partial failure.
  • This command writes. Add --staged to record it as a proposal a person applies with p202 change apply.
p202 commands text-ad create --json
{
  "path": "p202 text-ad create",
  "use": "create",
  "short": "Create a new text-ad",
  "runnable": true,
  "example": "p202 text-ad create --text-ad-name <text_ad_name> --text-ad-headline <text_ad_headline> --text-ad-description <text_ad_description> --text-ad-display-url <text_ad_display_url> --json",
  "flags": [
    {
      "name": "aff-campaign-id",
      "type": "string",
      "default": "",
      "usage": "Campaign ID (from `p202 campaign list`)",
      "required": false
    },
    {
      "name": "idempotency-key",
      "type": "string",
      "default": "",
      "usage": "Retry-safe create: the server records the response under this key and replays it on a retry with the same key and payload instead of creating a duplicate",
      "required": false
    },
    {
      "name": "landing-page-id",
      "type": "string",
      "default": "",
      "usage": "Landing page ID (from `p202 landing-page list`)",
      "required": false
    },
    {
      "name": "text-ad-description",
      "type": "string",
      "default": "",
      "usage": "Description text (required)",
      "required": true
    },
    {
      "name": "text-ad-display-url",
      "type": "string",
      "default": "",
      "usage": "Display URL (required)",
      "required": true
    },
    {
      "name": "text-ad-headline",
      "type": "string",
      "default": "",
      "usage": "Headline (required)",
      "required": true
    },
    {
      "name": "text-ad-name",
      "type": "string",
      "default": "",
      "usage": "Text ad name (required)",
      "required": true
    },
    {
      "name": "text-ad-type",
      "type": "string",
      "default": "",
      "usage": "Text ad type (integer)",
      "required": false
    }
  ]
}