Create an ad group based on the inputs passed in

post

https://ads.nextdoor.com/api/v3/advertisers/{advertiserId}/adgroups

Path Params

advertiserId

string

required

The id of the advertiser for which the request is made

Body Params

bid

object

The user configured bid for this ad group

budget

object

The user configured budget for this ad group

campaign_id

string

The campaign id to create an ad group for

conversion_optimization_goal

string | null

enum

The conversion optimization goal for this ad group

Allowed:

end_time

date-time | null

The end time for this ad group

frequency_caps

array of objects | null

The frequency cap data for this ad group

frequency_caps

name

string

The ad group name

placements

array of strings

The placements configured for this ad group

placements

Allowed:

start_time

date-time

The start time for this ad group

targeting

object | null

The targeting data for this ad group

user_status

string | null

enum

The user status to create this ad group as draft if needed

Allowed:

Responses

Language

Credentials

http

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The newly created ad group

400Bad Request. Indicates that the server cannot process the request due to client-side error. For example invalid input.

401Unauthorized. The API key is invalid and needs to be re-generated.

403Forbidden. The token passed in has been successfully authenticated, but can’t perform the given action due to not having sufficient permissions.

500Internal server error.

503The server is temporarily unable to handle the request due to maintenance or overload.