---
title: "v1 Creates a subscription on the server"
slug: "creates-a-subscription-on-the-server-1"
updated: 2024-03-26T16:37:23Z
published: 2024-03-26T16:37:23Z
canonical: "help.rapididentity.com/creates-a-subscription-on-the-server-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.rapididentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# v1 Creates a subscription on the server

Put/v1/tenants/{tenantId}/projects/{projectId}/subscriptions/{sub}

creates queues and routing keys so that you can publish and subscribe to a queue.

SecurityAPI KeyHeader parameter nameAuthorization

AWS Cognito Authorizer. Since there are no custom scopes the ID Token must be used for authorization

Path parameterstenantIdstringRequired

The RapidIdentity Cloud tenant id

projectIdstringRequired

The project id this service belongs. MUST be builtin or custom

substringRequired

The queue name.

Body parameters

Utilized to generate the routing key for the queue. This format is `tenants/{tenantId}/projects/{projectId}/topics/{sub}`

<select class='api-response-data'><option value='203fb282-50cc-48a9-8eab-34b189938c4c'>application/json</option>
</select><select class='select-example'><option value='8bfc1b01-f111-455d-9e4a-cc90f1e4b893'>topic</option>
</select>topic

An example for a topic

```json
{
  "topic": "tenants/1234/projects/custom/topics/alerts"
}
```

objecttopicstring  Required

Responses200

Subscription has been created successfully

<select class='api-response-data'><option value='d7184d6c-0bfb-472c-92e6-4c0d05f708d7'>application/json</option>
</select>objectsuccessstring  

403

The request is not authorized. Check that an api key exists and that the api key is valid for the tenantId

<select class='api-response-data'><option value='63d4233e-51e8-48d4-b6ea-73485ad5e780'>application/json</option>
</select>objecterrorstring  

500

Error creating dead letter subscription

<select class='api-response-data'><option value='d92ec698-8a1b-446a-bcdd-1af321999e77'>application/json</option>
</select>objecterrorstring  

501

The request does not have a projectId of custom or builtin

<select class='api-response-data'><option value='92d136f4-6f13-4088-b7a6-d0a6326c8dfc'>application/json</option>
</select>objecterrorstring  

503

Unable to connect to pubsub service

<select class='api-response-data'><option value='01bd9456-5197-415f-ac7f-366767129850'>application/json</option>
</select>objecterrorstring