API Reference

Introduction

The Outpost REST API is a JSON API for managing tenants, destinations, and publishing events to your webhook infrastructure.

All API endpoints require authentication. The base URL for the managed API is https://api.outpost.hookdeck.com/2025-07-01. For self-hosted deployments, your base URL is determined by your deployment configuration.

Authentication

The Outpost API supports two authentication methods depending on the operation:

Method	Description
Admin API Key	Bearer token for all admin operations. Set via the `API_KEY` environment variable (self-hosted) or the Hookdeck dashboard (managed).
Tenant JWT	Per-tenant JWT token valid for 24 hours. Used for tenant-scoped operations and portal access. Generated via the Get Tenant JWT Token endpoint.

Include your credentials as a Bearer token in every request:

# Admin API Key
curl https://api.outpost.hookdeck.com/2025-07-01/tenants \
  -H "Authorization: Bearer $API_KEY"

# Tenant JWT
curl https://api.outpost.hookdeck.com/2025-07-01/tenants/t1/destinations \
  -H "Authorization: Bearer $TENANT_JWT"

Rate Limits

The Outpost API applies rate limits per API key to ensure system stability. The default rate limit is 240 requests per minute. If you need a higher rate limit, contact us to increase it.

When a rate limit is exceeded, the API returns a 429 Too Many Requests response. Retry the request after the interval indicated in the Retry-After header.

Header	Description
`X-RateLimit-Limit`	Maximum requests allowed in the current window
`X-RateLimit-Remaining`	Requests remaining in the current window
`X-RateLimit-Reset`	Unix timestamp when the current window resets
`Retry-After`	Seconds to wait before retrying (present on 429 responses)

Rate limits are only applicable with managed deployments. Self-hosted deployments do not have rate limits and the operator is responsible for managing the service capacity.

HTTP/1.1 429 Too Many Requests
Retry-After: 1
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1704067260

{
  "error": "rate limit exceeded"
}

OpenAPI Schema

The Outpost OpenAPI schema is available and can be used to generate SDKs, import into Postman, or work with any OpenAPI-compatible tooling.

The schema is available in the Outpost GitHub repository.

# Download the schema
curl https://github.com/hookdeck/outpost/blob/main/docs/apis/openapi.yaml \
  -o outpost-openapi.json

# Import into Postman
# File → Import → Link → paste the URL above

SDKs

Official SDKs for the Outpost API are available for Go, TypeScript, and Python. All SDKs are generated by Speakeasy from the OpenAPI schema and published to their respective package registries.

Language	Package	Repository
TypeScript	`@hookdeck/outpost-sdk`	GitHub
Python	`outpost-sdk`	GitHub
Go	`outpost-go`	GitHub

# TypeScript / Node.js
npm install @hookdeck/outpost-sdk

# Python
pip install outpost-sdk

# Go
go get github.com/hookdeck/outpost/sdks/outpost-go

Tenants

Tenant object

The API segments resources per tenant. A tenant represents a user/team/organization in your product. The provided value determines the tenant's ID, which can be any string representation.

If your system is not multi-tenant, create a single tenant with a hard-code tenant ID upon initialization. If your system has a single tenant but multiple environments, create a tenant per environment, like live and test.

Example tenant object

JSON

{
  "id": "tenant_acme",
  "name": "Acme Corp",
  "metadata": {
    "plan": "pro",
    "region": "us-east-1"
  },
  "created_at": "2026-03-10T12:04:55Z",
  "updated_at": "2026-04-01T09:17:22Z"
}

List Tenants

List all tenants with cursor-based pagination.

When authenticated with a Tenant JWT, returns only the authenticated tenant. Pagination is not used in this case.

On Self-Hosted deployments, this endpoint requires Redis with RediSearch module (e.g., redis/redis-stack-server). If RediSearch is not available, this endpoint returns 501 Not Implemented.

GET

/tenants

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "models": [
    {
      "id": "123",
      "destinations_count": 5,
      "topics": [
        "user.created",
        "user.deleted"
      ],
      "metadata": {},
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "order_by": "created_at",
    "dir": "desc",
    "limit": 100,
    "next": "MTcwNDA2NzIwMA==",
    "prev": null
  },
  "count": 42
}

Create or Update Tenant

Idempotently creates or updates a tenant. Required before associating destinations.

PUT

/tenants/{tenant_id}

Request

Shell

curl -X PUT \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "metadata": {}
}'

Response

JSON

{
  "id": "123",
  "destinations_count": 5,
  "topics": [
    "user.created",
    "user.deleted"
  ],
  "metadata": {},
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:00:00Z"
}

Get Tenant

Retrieves details for a specific tenant.

GET

/tenants/{tenant_id}

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "id": "123",
  "destinations_count": 5,
  "topics": [
    "user.created",
    "user.deleted"
  ],
  "metadata": {},
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:00:00Z"
}

Delete Tenant

Deletes the tenant and all associated destinations.

DELETE

/tenants/{tenant_id}

Request

Shell

curl -X DELETE \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "success": true
}

Get Tenant JWT Token

Returns a JWT token scoped to the tenant for safe browser API calls. Requires Admin API Key.

GET

/tenants/{tenant_id}/token

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>/token" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "token": "SOME_JWT_TOKEN",
  "tenant_id": "tenant_123"
}

Get Portal Redirect URL

Returns a redirect URL containing a JWT to authenticate the user with the portal. Requires Admin API Key.

GET

/tenants/{tenant_id}/portal

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>/portal" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "redirect_url": "https://webhooks.acme.com/?token=JWT_TOKEN&tenant_id=tenant_123",
  "tenant_id": "tenant_123"
}

Destinations

Destinations are the endpoints where events are sent. Each destination is associated with a tenant and can be configured to receive specific event topics.

The topics array can contain either a list of topics or a wildcard * implying that all topics are supported. If you do not wish to implement topics for your application, you set all destination topics to *.

By default all destination credentials are obfuscated and the values cannot be read. This does not apply to the webhook type destination secret and each destination can expose their own obfuscation logic.

Destination object

Example destination object

JSON

{
  "id": "dst_01JQ79F6W3M5C9YJPE3QQ8B7K4",
  "tenant_id": "tenant_acme",
  "type": "webhook",
  "topics": [
    "order.created",
    "order.cancelled"
  ],
  "config": {
    "url": "https://example.com/webhooks/outpost",
    "headers": {
      "x-hookdeck-signature": "secret_123"
    }
  },
  "disabled_at": null,
  "created_at": "2026-03-10T12:10:33Z",
  "updated_at": "2026-04-01T09:21:40Z"
}

List Destinations

Return a list of the destinations for the tenant. The endpoint is not paged and the maximum number of destinations per tenant depends on your configuration

GET

/tenants/{tenant_id}/destinations

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>/destinations" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

[
  {
    "id": "des_webhook_123",
    "type": "webhook",
    "topics": [
      "user.created",
      "order.shipped"
    ],
    "disabled_at": null,
    "created_at": "2024-02-15T10:00:00Z",
    "updated_at": "2024-02-15T10:00:00Z",
    "config": {
      "url": "https://my-service.com/webhook/handler"
    },
    "credentials": {
      "secret": "whsec_abc123def456",
      "previous_secret": "whsec_prev789xyz012",
      "previous_secret_invalid_at": "2024-02-16T10:00:00Z"
    }
  }
]

Create Destination

Creates a new destination for the tenant. The request body structure depends on the type of the destination.

POST

/tenants/{tenant_id}/destinations

Request

Shell

curl -X POST \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>/destinations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "user-provided-id",
  "topics": "*",
  "filter": {
    "data": {
      "amount": {
        "$gte": 100
      },
      "customer": {
        "tier": "premium"
      }
    }
  },
  "config": {
    "url": "https://example.com/webhooks/user",
    "custom_headers": "{\"x-api-key\":\"secret123\",\"x-tenant-id\":\"customer-456\"}"
  },
  "credentials": {
    "secret": "whsec_abc123",
    "previous_secret": "whsec_xyz789",
    "previous_secret_invalid_at": "2024-01-02T00:00:00Z"
  },
  "delivery_metadata": {
    "app-id": "my-app",
    "region": "us-east-1"
  },
  "metadata": {
    "internal-id": "123",
    "team": "platform"
  }
}'

Response

JSON

{
  "id": "des_webhook_123",
  "type": "webhook",
  "topics": [
    "user.created",
    "order.shipped"
  ],
  "disabled_at": null,
  "created_at": "2024-02-15T10:00:00Z",
  "updated_at": "2024-02-15T10:00:00Z",
  "config": {
    "url": "https://my-service.com/webhook/handler"
  },
  "credentials": {
    "secret": "whsec_abc123def456",
    "previous_secret": "whsec_prev789xyz012",
    "previous_secret_invalid_at": "2024-02-16T10:00:00Z"
  }
}

Get Destination

Retrieves details for a specific destination.

GET

/tenants/{tenant_id}/destinations/{destination_id}

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>/destinations/<destination_id>" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "id": "des_webhook_123",
  "type": "webhook",
  "topics": [
    "user.created",
    "order.shipped"
  ],
  "disabled_at": null,
  "created_at": "2024-02-15T10:00:00Z",
  "updated_at": "2024-02-15T10:00:00Z",
  "config": {
    "url": "https://my-service.com/webhook/handler"
  },
  "credentials": {
    "secret": "whsec_abc123def456",
    "previous_secret": "whsec_prev789xyz012",
    "previous_secret_invalid_at": "2024-02-16T10:00:00Z"
  }
}

Update Destination

Updates the configuration of an existing destination. The request body structure depends on the destination's type. Type itself cannot be updated.

PATCH

/tenants/{tenant_id}/destinations/{destination_id}

Request

Shell

curl -X PATCH \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>/destinations/<destination_id>" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "topics": "*",
  "filter": {
    "data": {
      "amount": {
        "$gte": 100
      },
      "customer": {
        "tier": "premium"
      }
    }
  },
  "config": {
    "url": "https://example.com/webhooks/user",
    "custom_headers": "{\"x-api-key\":\"secret123\",\"x-tenant-id\":\"customer-456\"}"
  },
  "credentials": {},
  "delivery_metadata": {
    "app-id": "my-app",
    "region": "us-east-1"
  },
  "metadata": {
    "internal-id": "123",
    "team": "platform"
  }
}'

Response

JSON

{
  "id": "des_webhook_123",
  "type": "webhook",
  "topics": [
    "user.created",
    "order.shipped"
  ],
  "disabled_at": null,
  "created_at": "2024-02-15T10:00:00Z",
  "updated_at": "2024-02-15T10:00:00Z",
  "config": {
    "url": "https://my-service.com/webhook/handler"
  },
  "credentials": {
    "secret": "whsec_abc123def456",
    "previous_secret": "whsec_prev789xyz012",
    "previous_secret_invalid_at": "2024-02-16T10:00:00Z"
  }
}

Delete Destination

Deletes a specific destination. All events will be discarded and the destination will no longer receive any events. This action cannot be undone.

DELETE

/tenants/{tenant_id}/destinations/{destination_id}

Request

Shell

curl -X DELETE \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>/destinations/<destination_id>" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "success": true
}

Enable Destination

Enables a previously disabled destination. Any future events will be delivered to the destination.

PUT

/tenants/{tenant_id}/destinations/{destination_id}/enable

Request

Shell

curl -X PUT \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>/destinations/<destination_id>/enable" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "id": "des_webhook_123",
  "type": "webhook",
  "topics": [
    "user.created",
    "order.shipped"
  ],
  "disabled_at": null,
  "created_at": "2024-02-15T10:00:00Z",
  "updated_at": "2024-02-15T10:00:00Z",
  "config": {
    "url": "https://my-service.com/webhook/handler"
  },
  "credentials": {
    "secret": "whsec_abc123def456",
    "previous_secret": "whsec_prev789xyz012",
    "previous_secret_invalid_at": "2024-02-16T10:00:00Z"
  }
}

Disable Destination

Disables a previously enabled destination. All events will immediately be discarded and stop being delivered to the destination.

PUT

/tenants/{tenant_id}/destinations/{destination_id}/disable

Request

Shell

curl -X PUT \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>/destinations/<destination_id>/disable" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "id": "des_webhook_123",
  "type": "webhook",
  "topics": [
    "user.created",
    "order.shipped"
  ],
  "disabled_at": null,
  "created_at": "2024-02-15T10:00:00Z",
  "updated_at": "2024-02-15T10:00:00Z",
  "config": {
    "url": "https://my-service.com/webhook/handler"
  },
  "credentials": {
    "secret": "whsec_abc123def456",
    "previous_secret": "whsec_prev789xyz012",
    "previous_secret_invalid_at": "2024-02-16T10:00:00Z"
  }
}

List Destination Attempts

Retrieves a paginated list of attempts scoped to a specific destination.

GET

/tenants/{tenant_id}/destinations/{destination_id}/attempts

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>/destinations/<destination_id>/attempts" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "models": [
    {
      "id": "atm_123",
      "tenant_id": "tnt_123",
      "status": "success",
      "time": "2024-01-01T00:00:05Z",
      "code": "200",
      "response_data": {
        "status_code": 200,
        "body": "{\"status\":\"ok\"}",
        "headers": {
          "content-type": "application/json"
        }
      },
      "attempt_number": 1,
      "manual": false,
      "event_id": "evt_123",
      "destination_id": "des_456",
      "event": {
        "id": "evt_123",
        "tenant_id": "tnt_123",
        "destination_id": "des_456",
        "topic": "user.created",
        "time": "2024-01-01T00:00:00Z",
        "eligible_for_retry": true,
        "metadata": {
          "source": "crm"
        }
      },
      "destination": {
        "id": "des_webhook_123",
        "type": "webhook",
        "topics": [
          "user.created",
          "order.shipped"
        ],
        "disabled_at": null,
        "created_at": "2024-02-15T10:00:00Z",
        "updated_at": "2024-02-15T10:00:00Z",
        "config": {
          "url": "https://my-service.com/webhook/handler"
        },
        "credentials": {
          "secret": "whsec_abc123def456",
          "previous_secret": "whsec_prev789xyz012",
          "previous_secret_invalid_at": "2024-02-16T10:00:00Z"
        }
      }
    }
  ],
  "pagination": {
    "order_by": "created_at",
    "dir": "desc",
    "limit": 100,
    "next": "MTcwNDA2NzIwMA==",
    "prev": null
  }
}

Get Destination Attempt

Retrieves details for a specific attempt scoped to a destination.

GET

/tenants/{tenant_id}/destinations/{destination_id}/attempts/{attempt_id}

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/tenants/<tenant_id>/destinations/<destination_id>/attempts/<attempt_id>" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "id": "atm_123",
  "tenant_id": "tnt_123",
  "status": "success",
  "time": "2024-01-01T00:00:05Z",
  "code": "200",
  "response_data": {
    "status_code": 200,
    "body": "{\"status\":\"ok\"}",
    "headers": {
      "content-type": "application/json"
    }
  },
  "attempt_number": 1,
  "manual": false,
  "event_id": "evt_123",
  "destination_id": "des_456",
  "event": {
    "id": "evt_123",
    "tenant_id": "tnt_123",
    "destination_id": "des_456",
    "topic": "user.created",
    "time": "2024-01-01T00:00:00Z",
    "eligible_for_retry": true,
    "metadata": {
      "source": "crm"
    }
  },
  "destination": {
    "id": "des_webhook_123",
    "type": "webhook",
    "topics": [
      "user.created",
      "order.shipped"
    ],
    "disabled_at": null,
    "created_at": "2024-02-15T10:00:00Z",
    "updated_at": "2024-02-15T10:00:00Z",
    "config": {
      "url": "https://my-service.com/webhook/handler"
    },
    "credentials": {
      "secret": "whsec_abc123def456",
      "previous_secret": "whsec_prev789xyz012",
      "previous_secret_invalid_at": "2024-02-16T10:00:00Z"
    }
  }
}

Configuration

The Configuration API is available for managed Outpost deployments only. It allows you to read and update instance-level settings — the same settings available as environment variables in self-hosted deployments.

Get Configuration

Retrieves the current configuration for your managed Outpost instance.

GET

/configs

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/configs" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "TOPICS": "user.created,user.updated",
  "DESTINATIONS_WEBHOOK_MODE": "default"
}

Update Configuration

Updates the configuration for your managed Outpost instance.

PUT

/configs

Request

Shell

curl -X PUT \
  "https://api.outpost.hookdeck.com/2025-07-01/configs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "TOPICS": "user.created,user.updated",
  "DESTINATIONS_WEBHOOK_MODE": "default"
}'

Response

JSON

{
  "TOPICS": "user.created,user.updated",
  "DESTINATIONS_WEBHOOK_MODE": "default"
}

Publish Event

Use the Publish endpoint to send events into Outpost. Events are matched against all destinations whose topic subscriptions and filters match the event. Requires Admin API Key.

POST

/publish

Request

Shell

curl -X POST \
  "https://api.outpost.hookdeck.com/2025-07-01/publish" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "evt_custom_123",
  "tenant_id": "<TENANT_ID>",
  "destination_id": "<DESTINATION_ID>",
  "topic": "topic.name",
  "time": "2024-01-15T10:30:00Z",
  "metadata": {
    "source": "crm"
  },
  "data": {
    "user_id": "userid",
    "status": "active"
  }
}'

Retry Event Delivery

Triggers a retry for delivering an event to a destination. The event must exist and the destination must be enabled and match the event's topic.

When authenticated with a Tenant JWT, only events belonging to that tenant can be retried. When authenticated with Admin API Key, events from any tenant can be retried.

POST

/retry

Request

Shell

curl -X POST \
  "https://api.outpost.hookdeck.com/2025-07-01/retry" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "event_id": "evt_123",
  "destination_id": "des_456"
}'

Events

An event represents a payload published to Outpost. Events are matched against all destinations whose topic subscriptions match the event topic, then delivered.

Example attempt object

JSON

{
  "id": "evt_123",
  "topic": "user.created",
  "matched_destination_ids": [
    "des_456"
  ],
  "time": "2024-01-01T00:00:00Z",
  "eligible_for_retry": false,
  "metadata": {
    "source": "crm"
  },
  "data": {
    "user_id": "userid",
    "status": "active"
  }
}

List Events

Retrieves a list of events.

When authenticated with a Tenant JWT, returns only events belonging to that tenant. When authenticated with Admin API Key, returns events across all tenants. Use tenant_id query parameter to filter by tenant.

GET

/events

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/events" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "models": [
    {
      "id": "evt_123",
      "tenant_id": "tnt_123",
      "matched_destination_ids": [
        "des_456",
        "des_789"
      ],
      "topic": "user.created",
      "time": "2024-01-01T00:00:00Z",
      "metadata": {
        "source": "crm"
      },
      "data": {
        "user_id": "userid",
        "status": "active"
      }
    }
  ],
  "pagination": {
    "order_by": "created_at",
    "dir": "desc",
    "limit": 100,
    "next": "MTcwNDA2NzIwMA==",
    "prev": null
  }
}

Get Event

Retrieves details for a specific event.

When authenticated with a Tenant JWT, only events belonging to that tenant can be accessed. When authenticated with Admin API Key, events from any tenant can be accessed.

GET

/events/{event_id}

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/events/<event_id>" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "id": "evt_123",
  "tenant_id": "tnt_123",
  "matched_destination_ids": [
    "des_456",
    "des_789"
  ],
  "topic": "user.created",
  "time": "2024-01-01T00:00:00Z",
  "metadata": {
    "source": "crm"
  },
  "data": {
    "user_id": "userid",
    "status": "active"
  }
}

Delivery Attempts

Attempts represent individual delivery attempts of events to destinations. The attempts API provides an attempt-centric view of event processing.

Use the include query parameter to include related data:

include=event: Include event summary (id, topic, time, eligible_for_retry, metadata)
include=event.data: Include full event with payload data
include=response_data: Include response body and headers from the attempt
include=destination: Include the full destination object with target information

Example attempt object

JSON

{
  "id": "atm_123",
  "status": "success",
  "time": "2024-01-01T00:00:05Z",
  "code": "200",
  "attempt_number": 1,
  "event_id": "evt_123",
  "destination_id": "des_456"
}

List Attempts

Retrieves a paginated list of attempts.

When authenticated with a Tenant JWT, returns only attempts belonging to that tenant. When authenticated with Admin API Key, returns attempts across all tenants. Use tenant_id query parameter to filter by tenant.

GET

/attempts

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/attempts" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "models": [
    {
      "id": "atm_123",
      "tenant_id": "tnt_123",
      "status": "success",
      "time": "2024-01-01T00:00:05Z",
      "code": "200",
      "response_data": {
        "status_code": 200,
        "body": "{\"status\":\"ok\"}",
        "headers": {
          "content-type": "application/json"
        }
      },
      "attempt_number": 1,
      "manual": false,
      "event_id": "evt_123",
      "destination_id": "des_456",
      "event": {
        "id": "evt_123",
        "tenant_id": "tnt_123",
        "destination_id": "des_456",
        "topic": "user.created",
        "time": "2024-01-01T00:00:00Z",
        "eligible_for_retry": true,
        "metadata": {
          "source": "crm"
        }
      },
      "destination": {
        "id": "des_webhook_123",
        "type": "webhook",
        "topics": [
          "user.created",
          "order.shipped"
        ],
        "disabled_at": null,
        "created_at": "2024-02-15T10:00:00Z",
        "updated_at": "2024-02-15T10:00:00Z",
        "config": {
          "url": "https://my-service.com/webhook/handler"
        },
        "credentials": {
          "secret": "whsec_abc123def456",
          "previous_secret": "whsec_prev789xyz012",
          "previous_secret_invalid_at": "2024-02-16T10:00:00Z"
        }
      }
    }
  ],
  "pagination": {
    "order_by": "created_at",
    "dir": "desc",
    "limit": 100,
    "next": "MTcwNDA2NzIwMA==",
    "prev": null
  }
}

Get Attempt

Retrieves details for a specific attempt.

When authenticated with a Tenant JWT, only attempts belonging to that tenant can be accessed. When authenticated with Admin API Key, attempts from any tenant can be accessed.

GET

/attempts/{attempt_id}

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/attempts/<attempt_id>" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "id": "atm_123",
  "tenant_id": "tnt_123",
  "status": "success",
  "time": "2024-01-01T00:00:05Z",
  "code": "200",
  "response_data": {
    "status_code": 200,
    "body": "{\"status\":\"ok\"}",
    "headers": {
      "content-type": "application/json"
    }
  },
  "attempt_number": 1,
  "manual": false,
  "event_id": "evt_123",
  "destination_id": "des_456",
  "event": {
    "id": "evt_123",
    "tenant_id": "tnt_123",
    "destination_id": "des_456",
    "topic": "user.created",
    "time": "2024-01-01T00:00:00Z",
    "eligible_for_retry": true,
    "metadata": {
      "source": "crm"
    }
  },
  "destination": {
    "id": "des_webhook_123",
    "type": "webhook",
    "topics": [
      "user.created",
      "order.shipped"
    ],
    "disabled_at": null,
    "created_at": "2024-02-15T10:00:00Z",
    "updated_at": "2024-02-15T10:00:00Z",
    "config": {
      "url": "https://my-service.com/webhook/handler"
    },
    "credentials": {
      "secret": "whsec_abc123def456",
      "previous_secret": "whsec_prev789xyz012",
      "previous_secret_invalid_at": "2024-02-16T10:00:00Z"
    }
  }
}

Metrics

Aggregated metrics for events and delivery attempts. Supports time bucketing, dimensional grouping, and filtering.

Get Event Metrics

Returns aggregated event publish metrics. Supports time bucketing via granularity, dimensional grouping, and filtering.

Measures: count, rate

Dimensions: tenant_id (admin-only), topic, destination_id

Filters: tenant_id (admin-only), topic, destination_id

GET

/metrics/events

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/metrics/events" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "data": [
    {
      "time_bucket": "2026-03-02T14:00:00Z",
      "dimensions": {
        "destination_id": "dest_abc",
        "topic": "user.created"
      },
      "metrics": {
        "count": 1423,
        "error_rate": 0.02
      }
    }
  ],
  "metadata": {
    "granularity": "1h",
    "query_time_ms": 42,
    "row_count": 2,
    "row_limit": 100000,
    "truncated": false
  }
}

Get Attempt Metrics

Returns aggregated delivery attempt metrics. Supports time bucketing via granularity, dimensional grouping, and filtering.

Measures: count, successful_count, failed_count, error_rate, first_attempt_count, retry_count, manual_retry_count, avg_attempt_number, rate, successful_rate, failed_rate

Dimensions: tenant_id (admin-only), destination_id, topic, status, code, manual, attempt_number

Filters: tenant_id (admin-only), destination_id, topic, status, code, manual, attempt_number

GET

/metrics/attempts

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/metrics/attempts" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "data": [
    {
      "time_bucket": "2026-03-02T14:00:00Z",
      "dimensions": {
        "destination_id": "dest_abc",
        "topic": "user.created"
      },
      "metrics": {
        "count": 1423,
        "error_rate": 0.02
      }
    }
  ],
  "metadata": {
    "granularity": "1h",
    "query_time_ms": 42,
    "row_count": 2,
    "row_limit": 100000,
    "truncated": false
  }
}

Destination Types

Destination types describe the available event delivery targets and their configuration schemas. Use these endpoints to render UI forms and list available destination types with their configuration schemas.

Example destination type object

JSON

{
  "type": "webhook",
  "label": "Webhook",
  "description": "Send event via an HTTP POST request to a URL",
  "icon": "<svg />",
  "instructions": "Enter the URL...",
  "config_fields": [
    {
      "type": "text",
      "label": "URL",
      "description": "The URL to send the webhook to.",
      "pattern": "^https?://.*",
      "required": true
    }
  ],
  "credential_fields": [
    {
      "type": "text",
      "label": "Secret",
      "description": "Optional signing secret.",
      "required": false,
      "sensitive": true
    }
  ]
}

List Destination Type Schemas

Returns a list of JSON-based input schemas for each available destination type.

GET

/destination-types

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/destination-types" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

[
  {
    "type": "webhook",
    "label": "Webhook",
    "description": "Send event via an HTTP POST request to a URL",
    "icon": "<svg />",
    "instructions": "Some *markdown*",
    "remote_setup_url": "https://dashboard.hookdeck.com/authorize?provider=acme",
    "config_fields": [
      {
        "key": "url",
        "type": "text",
        "label": "URL",
        "description": "The URL to send the event to",
        "required": true,
        "sensitive": false,
        "default": "default_value",
        "minlength": 0,
        "maxlength": 255,
        "pattern": "^[a-zA-Z0-9_]+$",
        "options": [
          {
            "label": "PLAIN",
            "value": "plain"
          }
        ]
      }
    ],
    "credential_fields": [
      {
        "key": "url",
        "type": "text",
        "label": "URL",
        "description": "The URL to send the event to",
        "required": true,
        "sensitive": false,
        "default": "default_value",
        "minlength": 0,
        "maxlength": 255,
        "pattern": "^[a-zA-Z0-9_]+$",
        "options": [
          {
            "label": "PLAIN",
            "value": "plain"
          }
        ]
      }
    ]
  }
]

Get Destination Type Schema

Returns the input schema for a specific destination type.

GET

/destination-types/{type}

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/destination-types/<type>" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "type": "webhook",
  "label": "Webhook",
  "description": "Send event via an HTTP POST request to a URL",
  "icon": "<svg />",
  "instructions": "Some *markdown*",
  "remote_setup_url": "https://dashboard.hookdeck.com/authorize?provider=acme",
  "config_fields": [
    {
      "key": "url",
      "type": "text",
      "label": "URL",
      "description": "The URL to send the event to",
      "required": true,
      "sensitive": false,
      "default": "default_value",
      "minlength": 0,
      "maxlength": 255,
      "pattern": "^[a-zA-Z0-9_]+$",
      "options": [
        {
          "label": "PLAIN",
          "value": "plain"
        }
      ]
    }
  ],
  "credential_fields": [
    {
      "key": "url",
      "type": "text",
      "label": "URL",
      "description": "The URL to send the event to",
      "required": true,
      "sensitive": false,
      "default": "default_value",
      "minlength": 0,
      "maxlength": 255,
      "pattern": "^[a-zA-Z0-9_]+$",
      "options": [
        {
          "label": "PLAIN",
          "value": "plain"
        }
      ]
    }
  ]
}

Topics

List Available Topics

Returns the list of topics configured for this Outpost deployment. Tenants subscribe their destinations to topics from this list. Topics are defined via your configuration file and not a specific Create Topic API.

Health Check

This endpoint is only available for self-hosted Outpost deployments. Managed Outpost health is monitored by Hookdeck.

Health check endpoint that reports the status of all workers.

Returns HTTP 200 when all workers are healthy, or HTTP 503 if any worker has failed.

The response includes:

status: Overall health status ("healthy" or "failed")
timestamp: When this health check was performed (ISO 8601 format)
workers: Map of worker names to their individual health status

Each worker reports:

status: Worker health ("healthy" or "failed")

Error details are not exposed for security reasons. Check application logs for detailed error information.

GET

/healthz

Request

Shell

curl -X GET \
  "https://api.outpost.hookdeck.com/2025-07-01/healthz" \
  -H "Authorization: Bearer $API_KEY"

Response

JSON

{
  "status": "healthy",
  "timestamp": "2025-11-11T10:30:00Z",
  "workers": {}
}