​

Welcome

Landing’s API allows you to build powerful integrations using OAuth 2.0 for authentication and webhooks for real-time event notifications.

​

Authentication

All API endpoints are authenticated using Bearer tokens and picked up from the specification file.

​

OAuth 2.0 Integration

Landing supports OAuth 2.0 for secure third-party integrations, with optional PKCE (Proof Key for Code Exchange) support. The authentication process involves several steps:

1. Create an OAuth Application
2. Redirect Users to Authorization
3. Handle the Authorization Response
4. Exchange Code for Access Token
5. Make API Requests
6. Refresh Access Token

See our detailed OAuth 2.0 guide for complete implementation instructions.

​

Webhooks

Landing provides webhooks to notify your application about real-time events. Currently supported events:

• lead.created - Triggered when a new lead is created. Requires all available scopes (project.read, pages.read, leads.read, and user.read).

​

Setting Up Webhooks

Once authenticated via OAuth 2.0, you can create webhooks to receive event notifications using our webhook endpoints:

• Create a webhook
• Delete a webhook

Webhooks will send POST requests to your specified URL with event data in JSON format.

Example webhook payload for lead.created:

{
  "type": "email",
  "email": "john.doe@example.com"
}