Update Google Ads conversion mapping

curl --request PATCH \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/conversion-mappings/{mapping_id} \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "value_field": "grand_total",
  "is_enabled": true
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/conversion-mappings/{mapping_id}"

payload = {
    "value_field": "grand_total",
    "is_enabled": True
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({value_field: 'grand_total', is_enabled: true})
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/conversion-mappings/{mapping_id}', 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/conversion-mappings/{mapping_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'value_field' => 'grand_total',
    'is_enabled' => true
  ]),
  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/conversion-mappings/{mapping_id}"

	payload := strings.NewReader("{\n  \"value_field\": \"grand_total\",\n  \"is_enabled\": true\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://app.base44.com/api/apps/{app_id}/google-ads/conversion-mappings/{mapping_id}")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"value_field\": \"grand_total\",\n  \"is_enabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Patch.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"value_field\": \"grand_total\",\n  \"is_enabled\": true\n}"

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

{
  "id": "68b1c0d4e7b91d003c45a1f7",
  "account_id": "68b1c0d4e7b91d003c45a1f8",
  "entity_name": "Order",
  "trigger_action": "create",
  "conversion_type": "PURCHASE",
  "conversion_action_id": "7654321",
  "value_field": "total_price",
  "currency_field": "currency",
  "id_field": "order_number",
  "is_enabled": true,
  "created_date": "2026-08-25T11:20:00Z",
  "updated_date": "2026-08-25T14:05:00Z"
}

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

Conversions

Update Google Ads conversion mapping

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

Changes a conversion mapping.

Send only the fields you want to change. A field you leave out keeps its current value, and so does a field you send as null, so clear a field by sending an empty string rather than null. There is no account_id parameter here, because the mapping already knows which account it belongs to.

Turning is_enabled off is how you stop Base44 counting the mapping when it decides the account’s conversion events are configured, without losing the mapping itself.

A mapping does not report conversions on its own. Nothing fires a conversion when the mapped entity is written. The app has to fire it in the browser with gtag('event', 'conversion', ...), or you report it from the server with Upload conversions.

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

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time. Send only the fields documented here. Other request fields are not supported and their behavior can change.

PATCH

api

apps

{app_id}

google-ads

conversion-mappings

{mapping_id}

Update Google Ads conversion mapping

curl --request PATCH \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/conversion-mappings/{mapping_id} \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "value_field": "grand_total",
  "is_enabled": true
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/conversion-mappings/{mapping_id}"

payload = {
    "value_field": "grand_total",
    "is_enabled": True
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({value_field: 'grand_total', is_enabled: true})
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/conversion-mappings/{mapping_id}', 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/conversion-mappings/{mapping_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'value_field' => 'grand_total',
    'is_enabled' => true
  ]),
  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/conversion-mappings/{mapping_id}"

	payload := strings.NewReader("{\n  \"value_field\": \"grand_total\",\n  \"is_enabled\": true\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://app.base44.com/api/apps/{app_id}/google-ads/conversion-mappings/{mapping_id}")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"value_field\": \"grand_total\",\n  \"is_enabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Patch.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"value_field\": \"grand_total\",\n  \"is_enabled\": true\n}"

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

{
  "id": "68b1c0d4e7b91d003c45a1f7",
  "account_id": "68b1c0d4e7b91d003c45a1f8",
  "entity_name": "Order",
  "trigger_action": "create",
  "conversion_type": "PURCHASE",
  "conversion_action_id": "7654321",
  "value_field": "total_price",
  "currency_field": "currency",
  "id_field": "order_number",
  "is_enabled": true,
  "created_date": "2026-08-25T11:20:00Z",
  "updated_date": "2026-08-25T14:05:00Z"
}

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

mapping_id

string

required

ID of the mapping, as returned in id by List conversion mappings.

Body

application/json

entity_name

string

Name of the app entity whose write this goal belongs to.

Example:

"Order"

trigger_action

string

default:create

Which write on the entity the goal belongs to. Base44 uses create, update, and delete, and stores any other value as sent.

Example:

"create"

conversion_type

string

Which kind of conversion this is, using Google's category vocabulary such as PURCHASE, ADD_TO_CART, SIGN_UP, or LEAD. The value is stored as sent and not checked against Google's list.

Example:

"PURCHASE"

conversion_action_id

string

Google Ads' own ID for the goal to point at, as returned in google_action_id by List conversion actions. Send it alongside conversion_type and this one is matched first, with conversion_type as the fallback if it matches no goal on the account.

Example:

"7654321"

value_field

string

Field on the entity record holding the conversion amount. The wiring instructions fall back to amount when it is empty.

Example:

"total_price"

currency_field

string

Field on the entity record holding the currency code. The wiring instructions fall back to USD when it is empty.

Example:

"currency"

id_field

string

Field on the entity record holding the order ID Google dedupes on. The wiring instructions fall back to id when it is empty.

Example:

"order_number"

is_enabled

boolean

default:true

Whether Base44 counts this mapping when it decides the account's conversion events are configured (true) or ignores it (false).

Example:

true

Response

The mapping after the change.

A conversion goal tied to an entity write in the app.

string

required

ID of the mapping. Pass this as mapping_id to update or delete it.

Example:

"68b1c0d4e7b91d003c45a1f7"

account_id

string

required

ID of the Google Ads account the mapping belongs to.

Example:

"68b1c0d4e7b91d003c45a1f8"

entity_name

string

required

Name of the app entity whose write this goal belongs to, as returned by List entity schemas. It is empty on a mapping Base44 created from a conversion it verified firing in the app code, because a client-side conversion has no entity behind it.

Example:

"Order"

trigger_action

string

required

Which write on the entity the goal belongs to. Base44 uses create, update, and delete, and stores any other value as sent.

Example:

"create"

conversion_type

string

required

Which kind of conversion this is, using Google's category vocabulary such as PURCHASE, ADD_TO_CART, BEGIN_CHECKOUT, SIGN_UP, LEAD, or CONTACT. Empty when nothing was set for it. The value is stored as sent and not checked against Google's list.

Example:

"PURCHASE"

conversion_action_id

string

required

Google Ads' own ID for the goal this mapping points at, as returned in google_action_id by List conversion actions. Empty when nothing was set for it. A mapping can carry both this and conversion_type, and this one is matched first. If it matches no goal on the account, which happens when the goal was recreated in Google Ads under a new ID, the mapping falls back to matching on conversion_type.

Example:

"7654321"

value_field

string

required

Field on the entity record holding the conversion amount. It is read only when writing the wiring instructions for the AI builder, which falls back to amount when this is empty.

Example:

"total_price"

currency_field

string

required

Field on the entity record holding the currency code. Same use as value_field, and the instructions fall back to USD when this is empty.

Example:

"currency"

id_field

string

required

Field on the entity record holding the order ID Google dedupes on. Same use as value_field, and the instructions fall back to id when this is empty.

Example:

"order_number"

is_enabled

boolean

required

Whether Base44 counts this mapping when it decides a campaign's conversion events are configured (true) or ignores it (false).

Example:

true

created_date

string<date-time>

required

When the mapping was created.

Example:

"2026-08-25T11:20:00Z"

updated_date

string<date-time>

required

When the mapping was last changed.

Example:

"2026-08-25T14:05:00Z"

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

Update Google Ads conversion mapping

Authorizations

Path Parameters

Body

Response