ResellerHQ
Log inTry the sandbox free
GuidesAPI reference
MailboxesForwarding, DMARC and OAuth

List OAuth client IDs

GET
/v1/mailbox-domains/{id}/client-ids

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Path Parameters

id*string

Response Body

Success

application/json
  1. response

Success

data*array<>
curl -X GET "https://example.com/v1/mailbox-domains/mdm_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/client-ids"
{  "data": [    {      "id": "cid_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "mailboxDomainId": "mdm_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "clientId": "102938475610293847561",      "delegated": true,      "scopes": [        "string"      ],      "status": "pending",      "error": "string",      "completedAt": "2026-10-07T11:04:31.000Z",      "createdAt": "2026-10-07T11:04:31.000Z"    }  ]}

Grant an OAuth client ID POST

Trusts your app's Google OAuth client on the domain's Google account, so its mailboxes can sign in to it. `delegated: true` grants domain-wide delegation for `scopes` instead, so the app can act as any mailbox on the domain without each one signing in. Needs the domain’s admin mailbox set up. We follow the request and send `client_id.completed` or `client_id.failed`.

Check domains for mailboxes POST

Before ordering on several domains at once: whether each is connected here already (and how many more mailboxes it takes), held here, free to buy (and at what price), registered elsewhere, or cannot have mailboxes, such as one already used with Google Workspace elsewhere. `registrant` says whether a domain bought with the order has someone to be registered to.