Upload enhanced Google Ads conversions

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload-enhanced \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "adjustments": [
    {
      "conversion_action_id": "7654321",
      "order_id": "ORD-10482",
      "adjustment_date_time": "2026-08-26 09:15:00+00:00",
      "user_identifiers": {
        "hashed_email": "d5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f"
      }
    }
  ]
}
'

import requests

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

payload = { "adjustments": [
        {
            "conversion_action_id": "7654321",
            "order_id": "ORD-10482",
            "adjustment_date_time": "2026-08-26 09:15:00+00:00",
            "user_identifiers": { "hashed_email": "d5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f" }
        }
    ] }
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({
    adjustments: [
      {
        conversion_action_id: '7654321',
        order_id: 'ORD-10482',
        adjustment_date_time: '2026-08-26 09:15:00+00:00',
        user_identifiers: {
          hashed_email: 'd5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f'
        }
      }
    ]
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload-enhanced', 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-enhanced",
  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([
    'adjustments' => [
        [
                'conversion_action_id' => '7654321',
                'order_id' => 'ORD-10482',
                'adjustment_date_time' => '2026-08-26 09:15:00+00:00',
                'user_identifiers' => [
                                'hashed_email' => 'd5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f'
                ]
        ]
    ]
  ]),
  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-enhanced"

	payload := strings.NewReader("{\n  \"adjustments\": [\n    {\n      \"conversion_action_id\": \"7654321\",\n      \"order_id\": \"ORD-10482\",\n      \"adjustment_date_time\": \"2026-08-26 09:15:00+00:00\",\n      \"user_identifiers\": {\n        \"hashed_email\": \"d5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f\"\n      }\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-enhanced")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"adjustments\": [\n    {\n      \"conversion_action_id\": \"7654321\",\n      \"order_id\": \"ORD-10482\",\n      \"adjustment_date_time\": \"2026-08-26 09:15:00+00:00\",\n      \"user_identifiers\": {\n        \"hashed_email\": \"d5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f\"\n      }\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"adjustments\": [\n    {\n      \"conversion_action_id\": \"7654321\",\n      \"order_id\": \"ORD-10482\",\n      \"adjustment_date_time\": \"2026-08-26 09:15:00+00:00\",\n      \"user_identifiers\": {\n        \"hashed_email\": \"d5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f\"\n      }\n    }\n  ]\n}"

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

{
  "status": "success",
  "total_submitted": 5,
  "total_uploaded": 4
}

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

Conversions

Upload enhanced Google Ads conversions

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

Adds hashed buyer details to conversions you have already reported, so Google can match more of them to a click.

Use it when you learn who the buyer was after the conversion was reported, for example a form submitted after checkout. Each adjustment finds its conversion by the order_id you sent originally, so it only works for a conversion you reported with one. It changes the details on an existing conversion and never creates a new one, so Upload conversions has to run first.

Hash each value yourself with SHA-256 over the lowercased, trimmed input and send lowercase hex. Base44 forwards what you send without hashing or normalizing it, so an unhashed or differently formatted value simply fails to match and reports as accepted.

Read the outcome from total_uploaded rather than status, which reports success as soon as one adjustment lands.

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 the adjustments may or may not have landed. Unlike Upload conversions, this endpoint keeps no record of what it has sent, so a retry can apply the same adjustment twice. Check the conversion in Google Ads before retrying.

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-enhanced

Upload enhanced Google Ads conversions

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload-enhanced \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "adjustments": [
    {
      "conversion_action_id": "7654321",
      "order_id": "ORD-10482",
      "adjustment_date_time": "2026-08-26 09:15:00+00:00",
      "user_identifiers": {
        "hashed_email": "d5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f"
      }
    }
  ]
}
'

import requests

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

payload = { "adjustments": [
        {
            "conversion_action_id": "7654321",
            "order_id": "ORD-10482",
            "adjustment_date_time": "2026-08-26 09:15:00+00:00",
            "user_identifiers": { "hashed_email": "d5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f" }
        }
    ] }
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({
    adjustments: [
      {
        conversion_action_id: '7654321',
        order_id: 'ORD-10482',
        adjustment_date_time: '2026-08-26 09:15:00+00:00',
        user_identifiers: {
          hashed_email: 'd5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f'
        }
      }
    ]
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/conversions/upload-enhanced', 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-enhanced",
  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([
    'adjustments' => [
        [
                'conversion_action_id' => '7654321',
                'order_id' => 'ORD-10482',
                'adjustment_date_time' => '2026-08-26 09:15:00+00:00',
                'user_identifiers' => [
                                'hashed_email' => 'd5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f'
                ]
        ]
    ]
  ]),
  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-enhanced"

	payload := strings.NewReader("{\n  \"adjustments\": [\n    {\n      \"conversion_action_id\": \"7654321\",\n      \"order_id\": \"ORD-10482\",\n      \"adjustment_date_time\": \"2026-08-26 09:15:00+00:00\",\n      \"user_identifiers\": {\n        \"hashed_email\": \"d5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f\"\n      }\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-enhanced")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"adjustments\": [\n    {\n      \"conversion_action_id\": \"7654321\",\n      \"order_id\": \"ORD-10482\",\n      \"adjustment_date_time\": \"2026-08-26 09:15:00+00:00\",\n      \"user_identifiers\": {\n        \"hashed_email\": \"d5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f\"\n      }\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"adjustments\": [\n    {\n      \"conversion_action_id\": \"7654321\",\n      \"order_id\": \"ORD-10482\",\n      \"adjustment_date_time\": \"2026-08-26 09:15:00+00:00\",\n      \"user_identifiers\": {\n        \"hashed_email\": \"d5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f\"\n      }\n    }\n  ]\n}"

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

{
  "status": "success",
  "total_submitted": 5,
  "total_uploaded": 4
}

{
  "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

adjustments

object[]

The adjustments to apply. An empty list is accepted and changes nothing.

Show child attributes

Example:

[
  {
    "conversion_action_id": "7654321",
    "order_id": "ORD-10482",
    "adjustment_date_time": "2026-08-26 09:15:00+00:00",
    "user_identifiers": {
      "hashed_email": "d5b8e2b9a1c4f60e7a2f3c8d91b45e6f70a1c2d3e4f5061728394a5b6c7d8e9f"
    }
  }
]

Response

What happened to the batch of adjustments.

What happened to a batch of enhanced-conversion adjustments.

status

string

required

Whether anything reached Google. The value is success when at least one adjustment 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 adjustments you sent.

Example:

5

total_uploaded

integer

required

How many adjustments Google accepted. Anything short of total_submitted is made up of adjustments dropped for carrying no usable hashed identifier and adjustments Google rejected one by one, and the response does not separate the two.

Example:

4

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 enhanced Google Ads conversions

Authorizations

Path Parameters

Body

Response