beehiiv Developer Documentation

Starts the OAuth2 authorization code flow. This endpoint redirects the user to login and consent (if needed), then redirects back to your redirect_uri with a code and state.

Query parameters

client_idstringRequired

The OAuth application client ID (uid).

redirect_uristringRequired

Must exactly match one of the app's configured redirect URIs.

response_typestringRequired

Must be code for the authorization code flow.

scopestringOptional

Space-delimited list of requested scopes.

statestringOptional

Opaque value returned to your callback for CSRF protection.

code_challengestringOptional

PKCE code challenge for public clients.

code_challenge_methodenumOptional

PKCE challenge method (plain or S256).

Allowed values:

Response

Redirect

1	import requests
2
3	url = "https://app.beehiiv.com/oauth/authorize"
4
5	querystring = {"client_id":"WDgKDt_bHOXUfWRhGf2ovKZmFHQ9r_Erd01IPmz_boc","redirect_uri":"http://localhost:3008/callback","response_type":"code","scope":"posts:read","state":"12345678"}
6
7	payload = {
8	"response_type": "code",
9	"client_id": "a1b2c3d4e5f67890abcdef1234567890",
10	"redirect_uri": "https://app.example.com/oauth/callback",
11	"scope": "read_profile email",
12	"state": "xyz123abc456"
13	}
14	headers = {"Content-Type": "application/json"}
15
16	response = requests.get(url, json=payload, headers=headers, params=querystring)
17
18	print(response.json())

Authorize

Query parameters

Response

Errors