---
title: "Create, rotate or revoke the firm's Google Ads feed credentials"
method: POST
path: "/client-onboarding/google-ads"
tags: ["Client Onboarding"]
---

# Create, rotate or revoke the firm's Google Ads feed credentials

`POST /client-onboarding/google-ads`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/client-onboarding/google-ads`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Firm owner/admin only. Create refuses if a connection exists; rotate requires an existing connection. Rotation/revocation invalidates old credentials. Create/rotate return status plus credentials {username,password}, with the password shown only once. Store and transfer it privately. Does not write to Google or change campaign settings. The external feed is GET /api/client-onboarding/google-ads/purchases.csv, authenticated only by these HTTP Basic credentials, never a LedgerHQ account password. Returns CSV on success, 401 on invalid/revoked credentials, 429 on rate limit or 503 on temporary failure; no caching. The feed contains conversion_name, conversion_time (UTC ISO 8601), conversion_value (USD dollars), conversion_currency, order_id, gclid, gbraid, wbraid. Map these columns in Google Ads Data Manager and schedule daily imports.

## Request body

- object
  - `action` 'create' | 'rotate' | 'revoke', required
  - `confirm` true, required

## Response `200`

Updated status; one-time credentials for create/rotate

## Other responses

- `409`: Connection already exists or missing for rotation
- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)