Upload Google Ads conversions

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "conversions": [
    {
      "conversion_action_id": "7654321",
      "conversion_date_time": "2026-08-25 14:05:00+00:00",
      "gclid": "Cj0KCQjw1...",
      "conversion_value": 89.9,
      "currency_code": "EUR",
      "order_id": "ORD-10482"
    }
  ]
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload"

payload = { "conversions": [
        {
            "conversion_action_id": "7654321",
            "conversion_date_time": "2026-08-25 14:05:00+00:00",
            "gclid": "Cj0KCQjw1...",
            "conversion_value": 89.9,
            "currency_code": "EUR",
            "order_id": "ORD-10482"
        }
    ] }
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    conversions: [
      {
        conversion_action_id: '7654321',
        conversion_date_time: '2026-08-25 14:05:00+00:00',
        gclid: 'Cj0KCQjw1...',
        conversion_value: 89.9,
        currency_code: 'EUR',
        order_id: 'ORD-10482'
      }
    ]
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload', 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://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload",
  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([
    'conversions' => [
        [
                'conversion_action_id' => '7654321',
                'conversion_date_time' => '2026-08-25 14:05:00+00:00',
                'gclid' => 'Cj0KCQjw1...',
                'conversion_value' => 89.9,
                'currency_code' => 'EUR',
                'order_id' => 'ORD-10482'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$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://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload"

	payload := strings.NewReader("{\n  \"conversions\": [\n    {\n      \"conversion_action_id\": \"7654321\",\n      \"conversion_date_time\": \"2026-08-25 14:05:00+00:00\",\n      \"gclid\": \"Cj0KCQjw1...\",\n      \"conversion_value\": 89.9,\n      \"currency_code\": \"EUR\",\n      \"order_id\": \"ORD-10482\"\n    }\n  ]\n}")

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

	req.Header.Add("api_key", "<api-key>")
	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://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"conversions\": [\n    {\n      \"conversion_action_id\": \"7654321\",\n      \"conversion_date_time\": \"2026-08-25 14:05:00+00:00\",\n      \"gclid\": \"Cj0KCQjw1...\",\n      \"conversion_value\": 89.9,\n      \"currency_code\": \"EUR\",\n      \"order_id\": \"ORD-10482\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload")

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

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"conversions\": [\n    {\n      \"conversion_action_id\": \"7654321\",\n      \"conversion_date_time\": \"2026-08-25 14:05:00+00:00\",\n      \"gclid\": \"Cj0KCQjw1...\",\n      \"conversion_value\": 89.9,\n      \"currency_code\": \"EUR\",\n      \"order_id\": \"ORD-10482\"\n    }\n  ]\n}"

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

{
  "status": "success",
  "total_submitted": 12,
  "duplicates_removed": 1,
  "cross_request_duplicates": 2,
  "skipped_no_click_id": 1,
  "total_uploaded": 8
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Conversions

Upload Google Ads conversions

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Reports conversions to Google Ads from your own server, for the conversions only your server knows about.

This is the counterpart to the browser-side gtag('event', 'conversion', ...) call. Use it for a payment that actually settled, an order confirmed after review, or anything an ad blocker would stop the browser reporting. Each conversion needs the goal it counts towards, when it happened, and the click it came from.

Read the outcome from the counts rather than from status. A partial batch still comes back as success, so compare total_uploaded with total_submitted. The difference is accounted for by duplicates_removed, cross_request_duplicates, and skipped_no_click_id, and anything left over is rows Google rejected one by one. Google does not tell Base44 which rows those were, so the response cannot name them.

Send order_id on every conversion you can. Base44 remembers each conversion it has reported and never reports the same one twice, keyed on the order or click ID together with the goal and the timestamp, and that record does not expire. Sending a corrected value for a conversion you already reported has no effect for that reason. Use Upload enhanced conversions to add buyer details to a conversion you have already reported.

There is no cap on how many rows you can send and no rate limit on this endpoint. Base44 sends them to Google in batches of 2,000, one batch after another, while your request stays open, so a very large list means a very long request. Keep each call to a few thousand rows and send several calls instead.

A 409 means the request to Google timed out after it was sent, so those conversions may or may not have landed. Retrying is safe. Base44 has already recorded them as sent, so the retry reports them under cross_request_duplicates rather than counting them twice.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

POST

api

apps

{app_id}

google-ads

conversions

upload

Upload Google Ads conversions

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "conversions": [
    {
      "conversion_action_id": "7654321",
      "conversion_date_time": "2026-08-25 14:05:00+00:00",
      "gclid": "Cj0KCQjw1...",
      "conversion_value": 89.9,
      "currency_code": "EUR",
      "order_id": "ORD-10482"
    }
  ]
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload"

payload = { "conversions": [
        {
            "conversion_action_id": "7654321",
            "conversion_date_time": "2026-08-25 14:05:00+00:00",
            "gclid": "Cj0KCQjw1...",
            "conversion_value": 89.9,
            "currency_code": "EUR",
            "order_id": "ORD-10482"
        }
    ] }
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    conversions: [
      {
        conversion_action_id: '7654321',
        conversion_date_time: '2026-08-25 14:05:00+00:00',
        gclid: 'Cj0KCQjw1...',
        conversion_value: 89.9,
        currency_code: 'EUR',
        order_id: 'ORD-10482'
      }
    ]
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload', 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://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload",
  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([
    'conversions' => [
        [
                'conversion_action_id' => '7654321',
                'conversion_date_time' => '2026-08-25 14:05:00+00:00',
                'gclid' => 'Cj0KCQjw1...',
                'conversion_value' => 89.9,
                'currency_code' => 'EUR',
                'order_id' => 'ORD-10482'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$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://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload"

	payload := strings.NewReader("{\n  \"conversions\": [\n    {\n      \"conversion_action_id\": \"7654321\",\n      \"conversion_date_time\": \"2026-08-25 14:05:00+00:00\",\n      \"gclid\": \"Cj0KCQjw1...\",\n      \"conversion_value\": 89.9,\n      \"currency_code\": \"EUR\",\n      \"order_id\": \"ORD-10482\"\n    }\n  ]\n}")

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

	req.Header.Add("api_key", "<api-key>")
	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://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"conversions\": [\n    {\n      \"conversion_action_id\": \"7654321\",\n      \"conversion_date_time\": \"2026-08-25 14:05:00+00:00\",\n      \"gclid\": \"Cj0KCQjw1...\",\n      \"conversion_value\": 89.9,\n      \"currency_code\": \"EUR\",\n      \"order_id\": \"ORD-10482\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload")

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

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"conversions\": [\n    {\n      \"conversion_action_id\": \"7654321\",\n      \"conversion_date_time\": \"2026-08-25 14:05:00+00:00\",\n      \"gclid\": \"Cj0KCQjw1...\",\n      \"conversion_value\": 89.9,\n      \"currency_code\": \"EUR\",\n      \"order_id\": \"ORD-10482\"\n    }\n  ]\n}"

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

{
  "status": "success",
  "total_submitted": 12,
  "duplicates_removed": 1,
  "cross_request_duplicates": 2,
  "skipped_no_click_id": 1,
  "total_uploaded": 8
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose Google Ads conversion tracking you want to manage.

Body

application/json

conversions

object[]

The conversions to report. An empty list is accepted and reports nothing.

Show child attributes

Example:

[
  {
    "conversion_action_id": "7654321",
    "conversion_date_time": "2026-08-25 14:05:00+00:00",
    "gclid": "Cj0KCQjw1...",
    "conversion_value": 89.9,
    "currency_code": "EUR",
    "order_id": "ORD-10482"
  }
]

Response

What happened to each conversion in the batch.

What happened to a batch of uploaded conversions.

status

string

required

Whether anything reached Google. The value is success when at least one conversion landed and no_rows_uploaded when none did, so it does not tell you the whole batch landed.

Example:

"success"

total_submitted

integer

required

How many conversions you sent, counted before any of the checks below.

Example:

12

duplicates_removed

integer

required

How many conversions were dropped as duplicates of another conversion in the same request, matching on order or click ID together with the goal and the timestamp.

Example:

1

cross_request_duplicates

integer

required

How many conversions a previous request already reported. Base44 remembers every conversion it has sent, permanently, so a retried upload lands here instead of counting twice.

Example:

2

skipped_no_click_id

integer

required

How many conversions were dropped before Google saw them because they carried none of gclid, gbraid, or wbraid. Google requires one of the three.

Example:

1

total_uploaded

integer

required

How many conversions Google accepted.

Example:

8

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Upload Google Ads conversions

Authorizations

Path Parameters

Body

Response