---
title: "Create endpoint"
method: POST
path: "/api/v1/projects/{projectId}/endpoints"
tags: ["Endpoints"]
---

# Create endpoint

`POST /api/v1/projects/{projectId}/endpoints`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/api/v1/projects/{projectId}/endpoints`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Creates a new webhook endpoint for the project

## Path parameters

- `projectId` string, uuid, required

## Request body

- EndpointRequest
  - `url` string, required
  - `description` string
  - `secret` string
  - `enabled` boolean
  - `rateLimitPerSecond` integer: Per-endpoint delivery throttle. 0 removes the limit.
  - `allowedSourceIps` string
  - `signatureScheme` 'LEGACY' | 'STANDARD' | 'BOTH'
  - `consumerId` string, uuid: The Consumer this endpoint belongs to, which puts it in that Consumer's portal. Absent leaves the current assignment alone.

## Response `201`

Endpoint created

---

[API](https://skmtc.dev/railhook/apis/railhook-api.md) · [All operations](https://skmtc.dev/railhook/apis/railhook-api/llms.txt) · [OpenAPI document](https://skmtc.dev/railhook/apis/railhook-api/revisions/4e2c76dfc33d?raw)