GET
/
api
/
v2
/
endpoints
GET https://inbound.new/api/v2/endpoints

{
  "data": [
    {
      "id": "ep_abc123",
      "name": "Production Webhook",
      "type": "webhook",
      "config": {
        "url": "https://api.example.com/webhook",
        "timeout": 30,
        "retryAttempts": 3
      },
      "isActive": true,
      "description": "Main webhook for production alerts",
      "userId": "user_123",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z",
      "groupEmails": null,
      "deliveryStats": {
        "total": 145,
        "successful": 142,
        "failed": 3,
        "lastDelivery": "2024-01-15T14:30:00Z"
      }
    },
    {
      "id": "ep_def456",
      "name": "Support Team",
      "type": "email_group",
      "config": {
        "emails": ["support@example.com", "alerts@example.com"],
        "includeAttachments": true,
        "subjectPrefix": "[SUPPORT]"
      },
      "isActive": true,
      "description": "Forward emails to support team",
      "userId": "user_123",
      "createdAt": "2024-01-14T09:15:00Z",
      "updatedAt": "2024-01-14T09:15:00Z",
      "groupEmails": ["support@example.com", "alerts@example.com"],
      "deliveryStats": {
        "total": 23,
        "successful": 23,
        "failed": 0,
        "lastDelivery": "2024-01-15T12:00:00Z"
      }
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 2,
    "hasMore": false
  }
}

​
Overview

Get a paginated list of all endpoints in your account. Endpoints are the unified routing system for webhooks, email forwarding, and email groups. 
GET https://inbound.new/api/v2/endpoints

​
Authentication

​
Authorization
string
required
Bearer token for API authentication. Format: Bearer YOUR_API_KEY

​
Query Parameters

​
limit
integer
default:"50"
Maximum number of results to return. Range: 1-100.
​
offset
integer
default:"0"
Number of results to skip for pagination. Must be non-negative.
​
type
string
Filter by endpoint type. Valid values: webhook, email, email_group.
​
active
boolean
Filter by active status. Pass true for active endpoints, false for inactive.

​
Response

{
  "data": [
    {
      "id": "ep_abc123",
      "name": "Production Webhook",
      "type": "webhook",
      "config": {
        "url": "https://api.example.com/webhook",
        "timeout": 30,
        "retryAttempts": 3
      },
      "isActive": true,
      "description": "Main webhook for production alerts",
      "userId": "user_123",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z",
      "groupEmails": null,
      "deliveryStats": {
        "total": 145,
        "successful": 142,
        "failed": 3,
        "lastDelivery": "2024-01-15T14:30:00Z"
      }
    },
    {
      "id": "ep_def456",
      "name": "Support Team",
      "type": "email_group",
      "config": {
        "emails": ["support@example.com", "alerts@example.com"],
        "includeAttachments": true,
        "subjectPrefix": "[SUPPORT]"
      },
      "isActive": true,
      "description": "Forward emails to support team",
      "userId": "user_123",
      "createdAt": "2024-01-14T09:15:00Z",
      "updatedAt": "2024-01-14T09:15:00Z",
      "groupEmails": ["support@example.com", "alerts@example.com"],
      "deliveryStats": {
        "total": 23,
        "successful": 23,
        "failed": 0,
        "lastDelivery": "2024-01-15T12:00:00Z"
      }
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 2,
    "hasMore": false
  }
}

​
Response Fields

​
data
array
Array of endpoint objects matching the query parameters.
​
pagination
object
Pagination information for the results.

​
Examples

​
Basic Usage

curl -X GET "https://inbound.new/api/v2/endpoints" \
  -H "Authorization: Bearer your_api_key"

​
Filtering by Type

curl -X GET "https://inbound.new/api/v2/endpoints?type=webhook&active=true" \
  -H "Authorization: Bearer your_api_key"

​
Pagination

curl -X GET "https://inbound.new/api/v2/endpoints?limit=10&offset=20" \
  -H "Authorization: Bearer your_api_key"

​
Error Responses

​
Endpoint Types

Webhook

Send email data to an external URL via HTTP POST

Email Forward

Forward emails to a single email address

Email Group

Forward emails to multiple email addresses (up to 50)