curl -X PATCH "https://api.adrelay.dev/v1/connections/conn_abc123" \
-H "X-API-Key: $ADRELAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"label": "US Google Ads Account"}'
const response = await fetch(
"https://api.adrelay.dev/v1/connections/conn_abc123",
{
method: "PATCH",
headers: {
"X-API-Key": process.env.ADRELAY_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ label: "US Google Ads Account" }),
}
);
const connection = await response.json();
import requests
response = requests.patch(
"https://api.adrelay.dev/v1/connections/conn_abc123",
headers={
"X-API-Key": "your-api-key-here",
"Content-Type": "application/json",
},
json={"label": "US Google Ads Account"},
)
connection = response.json()
{
"id": "conn_abc123",
"platform": "google_ads",
"status": "ACTIVE",
"label": "US Google Ads Account",
"remote_account_id": "123-456-7890",
"created_at": "2026-03-01T12:00:00Z",
"last_synced_at": "2026-03-21T08:00:00Z"
}
{
"error": "Connection not found.",
"code": "NOT_FOUND",
"timestamp": 1711036800,
"request_id": "req_abc123"
}
Connections
Update Connection
Update a connection’s label or other mutable properties.
PATCH
/
v1
/
connections
/
{connectionId}
curl -X PATCH "https://api.adrelay.dev/v1/connections/conn_abc123" \
-H "X-API-Key: $ADRELAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"label": "US Google Ads Account"}'
const response = await fetch(
"https://api.adrelay.dev/v1/connections/conn_abc123",
{
method: "PATCH",
headers: {
"X-API-Key": process.env.ADRELAY_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ label: "US Google Ads Account" }),
}
);
const connection = await response.json();
import requests
response = requests.patch(
"https://api.adrelay.dev/v1/connections/conn_abc123",
headers={
"X-API-Key": "your-api-key-here",
"Content-Type": "application/json",
},
json={"label": "US Google Ads Account"},
)
connection = response.json()
{
"id": "conn_abc123",
"platform": "google_ads",
"status": "ACTIVE",
"label": "US Google Ads Account",
"remote_account_id": "123-456-7890",
"created_at": "2026-03-01T12:00:00Z",
"last_synced_at": "2026-03-21T08:00:00Z"
}
{
"error": "Connection not found.",
"code": "NOT_FOUND",
"timestamp": 1711036800,
"request_id": "req_abc123"
}
curl -X PATCH "https://api.adrelay.dev/v1/connections/conn_abc123" \
-H "X-API-Key: $ADRELAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"label": "US Google Ads Account"}'
const response = await fetch(
"https://api.adrelay.dev/v1/connections/conn_abc123",
{
method: "PATCH",
headers: {
"X-API-Key": process.env.ADRELAY_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ label: "US Google Ads Account" }),
}
);
const connection = await response.json();
import requests
response = requests.patch(
"https://api.adrelay.dev/v1/connections/conn_abc123",
headers={
"X-API-Key": "your-api-key-here",
"Content-Type": "application/json",
},
json={"label": "US Google Ads Account"},
)
connection = response.json()
{
"id": "conn_abc123",
"platform": "google_ads",
"status": "ACTIVE",
"label": "US Google Ads Account",
"remote_account_id": "123-456-7890",
"created_at": "2026-03-01T12:00:00Z",
"last_synced_at": "2026-03-21T08:00:00Z"
}
{
"error": "Connection not found.",
"code": "NOT_FOUND",
"timestamp": 1711036800,
"request_id": "req_abc123"
}
label field to assign a human-readable name to your connections for easier identification when managing multiple accounts.Authorizations
Path Parameters
Body
application/json
Maximum string length:
100Response
Updated connection
Available options:
GOOGLE, META, TIKTOK, LINKEDIN, PINTEREST, REDDIT Available options:
PENDING, ACTIVE, REVOKED, ERROR