Create Endpoint

This endpoint creates a new endpoint and subscribe it to a topic.

POST /v1/endpoints

curl

curl -X POST https://qstash.upstash.io/v1/endpoints \
  -H "Authorization: Bearer <token>" \
  -d {
       "topicId": "tpc_7EfEryZiheEKzpMuvjYdhhhbNNJA",
       "url": "https://www.google.com"
     }

200

{
  "endpointId": "ept_6j7BNZus3ZyPy6P7QtLUMCC3Rq7h",
  "url": "https://www.upstash.com",
  "topicId": "tpc_7EfEryZiheEKzpMuvjYdhhhbNNJA"
}

Request

topicId · string

The id of the topic this endpoint subscribes to.

Either topicId or topicName must be set

topicName · string

The name of the topic this endpoint subscribes to.

Either topicId or topicName must be set

url · string · required

The url where all requests will be sent to.

Response

topicId · string · required

The id of the topic this endpoint subscribes to.

Either topicId or topicName must be set

topicName · string · required

The name of the topic this endpoint subscribes to.

Either topicId or topicName must be set

url · string · required

The url where all requests will be sent to.

curl

curl -X POST https://qstash.upstash.io/v1/endpoints \
  -H "Authorization: Bearer <token>" \
  -d {
       "topicId": "tpc_7EfEryZiheEKzpMuvjYdhhhbNNJA",
       "url": "https://www.google.com"
     }

200

{
  "endpointId": "ept_6j7BNZus3ZyPy6P7QtLUMCC3Rq7h",
  "url": "https://www.upstash.com",
  "topicId": "tpc_7EfEryZiheEKzpMuvjYdhhhbNNJA"
}