# "Subscriptions" Endpoints - POST Creates a subscription

**URL:** <https://community.toggl.com/t/subscriptions-endpoints-post-creates-a-subscription/405>\
**Category:** Webhooks API\
**Tags:** subscription, api, endpoints, post, webhooks\
**Created:** [December 2, 2024, 5:51pm UTC](https://community.toggl.com/t/subscriptions-endpoints-post-creates-a-subscription/405 "2024-12-02T17:51:31Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Support](https://yyz2.discourse-cdn.com/flex012/user_avatar/community.toggl.com/support/32/1577_2.png) [@Support](https://community.toggl.com/u/Support)\
**Post date:** [December 2, 2024, 5:51pm UTC](https://community.toggl.com/t/subscriptions-endpoints-post-creates-a-subscription/405/1 "2024-12-02T17:51:31Z")

</div>

```auto
https://api.track.toggl.com/webhooks/api/v1/subscriptions/{workspace_id}

```

Creates a subscription for the requested workspace ID.

- cURL
- Go
- Ruby
- JavaScript
- Python
- Rust

```auto
extern crate tokio;extern crate serde_json;use reqwest::{Client};use reqwest::header::{CONTENT_TYPE};#[tokio::main]async fn main() -> Result<(), reqwest::Error> { let client = Client::new(); let json = client.request(Method::POST, "https://api.track.toggl.com/webhooks/api/v1/subscriptions/{workspace_id}".to_string()).json(&serde_json::json!(\{"created_at":"string","deleted_at":"string","description":"string","enabled":"boolean","event_filters":[\{\}],"has_pending_events":"boolean","secret":"string","subscription_id":"integer","updated_at":"string","url_callback":"string","user_id":"integer","validated_at":"string","workspace_id":"integer"\})) .header(CONTENT_TYPE, "application/json") .send() .await? .json() .await?; println!("{:#?}", json); Ok(())}

```

### Parameters[​](https://engineering.toggl.com/docs/webhooks/subscriptions/#parameters-1)

#### Path[​](https://engineering.toggl.com/docs/webhooks/subscriptions/#path-1)

| name | type | required | description |
| --- | --- | --- | --- |
| workspace\_id | integer | true | Numeric ID of the workspace |

#### Body[​](https://engineering.toggl.com/docs/webhooks/subscriptions/#body)

| Name | Type | Description |
| --- | --- | --- |
| created\_at | string | - |
| deleted\_at | string | - |
| description | string | - |
| enabled | boolean | - |
| event\_filters | Array of SubscriptionEventFilter | - |
| has\_pending\_events | boolean | - |
| secret | string | - |
| subscription\_id | integer | - |
| updated\_at | string | - |
| url\_callback | string | - |
| user\_id | integer | - |
| validated\_at | string | - |
| workspace\_id | integer | - |

### Response[​](https://engineering.toggl.com/docs/webhooks/subscriptions/#response-1)

#### 200[​](https://engineering.toggl.com/docs/webhooks/subscriptions/#200-1)

| Name | Type | Description |
| --- | --- | --- |
| created\_at | string | - |
| deleted\_at | string | - |
| description | string | - |
| enabled | boolean | - |
| event\_filters | Array of SubscriptionEventFilter | - |
| has\_pending\_events | boolean | - |
| secret | string | - |
| subscription\_id | integer | - |
| updated\_at | string | - |
| url\_callback | string | - |
| user\_id | integer | - |
| validated\_at | string | - |
| workspace\_id | integer | - |

#### 400[​](https://engineering.toggl.com/docs/webhooks/subscriptions/#400)

Possible error messages:

- URL endpoint {url\_callback} responded with status {HTTP status code} instead of 200
- URL endpoint {url\_callback} request failed with error: {HTTP error}
- User {user\_id} already reached the limit of {allowed limit} enabled subscriptions for workspace {workspace\_id}
- Subscription description must not be empty
- Subscription description ‘{description}’ is already in use for workspace {workspace\_id}
- The list of event filters must not be empty
- The limit of {allowed limit} event filters for your subscription has been exceeded as you’re trying to set {number of filters} filters
- The following event filter appears more than once for your subscription: {subscription\_id}
- The entity field for each subscription event filter must be non-empty
- The value ‘{entity}’ for the filter entity can only contain letters, numbers and ‘\_’ or be ‘\*’ to match all entities
- The action field for each subscription event filter must be non-empty
- The value ‘{action}’ for the filter action can only contain letters, numbers and ‘\_’ or be ‘\*’ to match all actions
- Invalid value ‘{action}’ for event filter action

#### 403[​](https://engineering.toggl.com/docs/webhooks/subscriptions/#403-1)

User not found/accessible for workspace

#### 500[​](https://engineering.toggl.com/docs/webhooks/subscriptions/#500-1)

Internal Server Error