provider reverse_proxyproxy_records POST /api/organizations/{organization_id}/proxy_records/
@utdk/posthog /api/organizations/{organization_id}/proxy_records/
proxy_records_create
Create a new managed reverse proxy. Provide the domain you want to proxy through. The response includes the CNAME target you need to add as a DNS record. Once the CNAME is configured, the proxy will be automatically verified and provisioned.
organization_id path required
ID of the organization you're trying to access. To find the ID of the organization, make a call to /api/organizations/.
string

Try it

Authentication
Configure credentials for PostHog API
proxyRecordsCreate
POST/api/organizations/{organization_id}/proxy_records/
Create a new managed reverse proxy. Provide the domain you want to proxy through. The response includes the CNAME target you need to add as a DNS record. Once the CNAME is configured, the proxy will be automatically verified and provisioned.

Parameters

required

ID of the organization you're trying to access. To find the ID of the organization, make a call to /api/organizations/.

Input

required

Unique identifier for the proxy record.

required

The custom domain to proxy through, e.g. 'e.example.com'. Must be a valid subdomain you control.

required

The CNAME target to add as a DNS record for your domain. Point your domain's CNAME to this value.

required

Current provisioning status. Values: waiting (DNS verification pending), issuing (SSL certificate being issued), valid (proxy is live and working), warning (proxy has issues but is operational), erroring (proxy setup failed), deleting (removal in progress), timed_out (DNS verification timed out). * `waiting` - Waiting * `issuing` - Issuing * `valid` - Valid * `warning` - Warning * `erroring` - Erroring * `deleting` - Deleting * `timed_out` - Timed Out

required

Human-readable status message with details about errors or warnings, if any.

required

When this proxy record was created.

required

When this proxy record was last updated.

required

ID of the user who created this proxy record.

Configure credentials above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import posthog from '@utdk/posthog';

await posthog.proxyRecordsCreate()