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

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

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