Create Google Ads ad group

curl --request POST \
  --url https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "cpcBid": 123,
  "loginCustomerId": "<string>",
  "validateOnly": true
}
'

import requests

url = "https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups"

payload = {
    "name": "<string>",
    "cpcBid": 123,
    "loginCustomerId": "<string>",
    "validateOnly": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>', cpcBid: 123, loginCustomerId: '<string>', validateOnly: true})
};

fetch('https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'cpcBid' => 123,
    'loginCustomerId' => '<string>',
    'validateOnly' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"cpcBid\": 123,\n  \"loginCustomerId\": \"<string>\",\n  \"validateOnly\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"cpcBid\": 123,\n  \"loginCustomerId\": \"<string>\",\n  \"validateOnly\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"cpcBid\": 123,\n  \"loginCustomerId\": \"<string>\",\n  \"validateOnly\": true\n}"

response = http.request(request)
puts response.read_body

{
  "adGroup": {
    "adGroupId": "<string>",
    "resourceName": "<string>",
    "campaignId": "<string>",
    "name": "<string>",
    "status": "<string>",
    "type": "<string>",
    "cpcBidMicros": 123
  }
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

POST

projects

{projectId}

google-ads

customers

{customerId}

campaigns

{campaignId}

ad-groups

Create Google Ads ad group

curl --request POST \
  --url https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "cpcBid": 123,
  "loginCustomerId": "<string>",
  "validateOnly": true
}
'

import requests

url = "https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups"

payload = {
    "name": "<string>",
    "cpcBid": 123,
    "loginCustomerId": "<string>",
    "validateOnly": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>', cpcBid: 123, loginCustomerId: '<string>', validateOnly: true})
};

fetch('https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'cpcBid' => 123,
    'loginCustomerId' => '<string>',
    'validateOnly' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"cpcBid\": 123,\n  \"loginCustomerId\": \"<string>\",\n  \"validateOnly\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"cpcBid\": 123,\n  \"loginCustomerId\": \"<string>\",\n  \"validateOnly\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/ad-groups")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"cpcBid\": 123,\n  \"loginCustomerId\": \"<string>\",\n  \"validateOnly\": true\n}"

response = http.request(request)
puts response.read_body

{
  "adGroup": {
    "adGroupId": "<string>",
    "resourceName": "<string>",
    "campaignId": "<string>",
    "name": "<string>",
    "status": "<string>",
    "type": "<string>",
    "cpcBidMicros": 123
  }
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

Authorizations

Authorization

string

header

required

JWT token obtained from /api/auth/token endpoint. Token is verified using JWKS and must include a valid user identifier.

Path Parameters

projectId

string<uuid>

required

customerId

string

required

Minimum string length: 1

campaignId

string

required

Minimum string length: 1

Body

application/json

name

string

required

Required string length: 1 - 255

status

enum<string>

Available options:

ENABLED,

PAUSED

cpcBid

number

Minimum string length: 1

validateOnly

boolean

Response

Success

adGroup

object

required

Show child attributes

Agents

Auth

CMS

Assets

Memory

Actions

Schedules

Contracts

Emails

Invitations

Projects

Integrations

Conversions

CRM

Calendar

Google Ads

Geo

Workflows

OAuth Clients

Project Roles

Project Templates

Dashboard Sidebar

Service Accounts

Google Analytics

Google Business

Socials

Ads

Team

Users

Web Analytics

Create Google Ads ad group

Authorizations

Path Parameters

Body

Response