Skip to main content
POST
/
api
/
v1
/
campaigns
/
drafts
/
{draft_id}
/
ad-groups
/
{ad_group_id}
/
keywords
Add a keyword to an ad group
curl --request POST \
  --url http://localhost:8000/api/v1/campaigns/drafts/{draft_id}/ad-groups/{ad_group_id}/keywords \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "<string>",
  "match_type": "PHRASE",
  "cpc_bid_micros": 123,
  "final_url": "<string>"
}
'
{
  "id": 123,
  "text": "<string>",
  "match_type": "EXACT",
  "cpc_bid_micros": 25000000000,
  "final_url": "<string>",
  "source_market_analysis_keyword_id": 123
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
draft_id
integer
required
​
ad_group_id
integer
required

Query Parameters

​
regenerate_rsas
boolean
default:true

Auto-regenerate RSAs for the parent ad group

Body

application/json

Request to create a keyword in an ad group.

​
text
string
required

The keyword phrase

Required string length: 1 - 80
​
match_type
enum<string>
default:PHRASE

The keyword match types.

Available options:
EXACT,
PHRASE,
BROAD,
BROAD_MODIFIER,
NEGATIVE
​
cpc_bid_micros
integer | null

Optional keyword level bid

​
final_url
string<uri> | null

Optional keyword-level URL

Required string length: 1 - 2083

Response

Successful Response

Keyword within a draft ad group.

​
id
integer
required
​
text
string
required
​
match_type
enum<string>
required

The keyword match types.

Available options:
EXACT,
PHRASE,
BROAD,
BROAD_MODIFIER,
NEGATIVE
​
cpc_bid_micros
integer | null
Required range: 0 <= x <= 50000000000
​
final_url
string<uri> | null
Required string length: 1 - 2083
​
source_market_analysis_keyword_id
integer | null