# Get trigger type by slug

**Documentation:** /reference/api-reference/triggers/getTriggersTypesBySlug

Retrieve detailed information about a specific trigger type using its slug identifier

---

## GET `/api/v3/triggers_types/{slug}`

**Endpoint:** `https://backend.composio.dev/api/v3/triggers_types/{slug}`

**Summary:** Get trigger type by slug

Retrieve detailed information about a specific trigger type using its slug identifier

### Authentication

**ApiKeyAuth** - API Key in `header` header `x-api-key` OR **UserApiKeyAuth** - API Key in `header` header `x-user-api-key`

### Path Parameters

- `slug` (string) *(required)*: The unique slug identifier for the trigger type. Case-insensitive (internally normalized to uppercase).

### Query Parameters

- `toolkit_versions` (any): Toolkit version specification. Use "latest" for latest versions or bracket notation for specific versions per toolkit.

### Responses

#### 200 - Successfully retrieved trigger type

**Response Schema:**

- `slug` (string) *(required)*: Unique identifier for the trigger type
- `name` (string) *(required)*: Human-readable name of the trigger
- `description` (string) *(required)*: Detailed description of what the trigger does
- `instructions` (string) *(required)*: Step-by-step instructions on how to set up and use this trigger
- `type` (enum: "webhook" | "poll") *(required)*: The trigger mechanism - either webhook (event-based) or poll (scheduled check)
- `toolkit` (object) *(required)*: Information about the toolkit that provides this trigger
  - `slug` (string) *(required)*: Unique identifier for the parent toolkit
  - `name` (string) *(required)*: Deprecated: Use slug instead
  - `logo` (string) *(required)*: Logo of the toolkit
- `config` (object) *(required)*: Configuration schema required to set up this trigger
  - `[key: string]` (any)
- `payload` (object) *(required)*: Schema of the data payload this trigger will deliver when it fires
  - `[key: string]` (any)
- `version` (string) *(required)*: Version of the trigger type

**Example Response:**

```json
{
  "slug": "string",
  "name": "string",
  "description": "string",
  "instructions": "string",
  "type": "webhook",
  "toolkit": {
    "slug": "string",
    "name": "string",
    "logo": "string"
  },
  "config": {
    "key": null
  },
  "payload": {
    "key": null
  },
  "version": "string"
}
```

#### 400 - Bad request

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 401 - Unauthorized

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 404 - Not found

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 500 - Internal server error

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

### Example cURL Request

```bash
curl -X GET "https://backend.composio.dev/api/v3/triggers_types/string" \
  -H "x-api-key: YOUR_API_KEY"
```