Trello Developer

Trello Developer

Rate this page:

Webhooks

Create a Webhook

POST /1/webhooks/

Create a new webhook.

Request

Query parameters
key Required

string

The API key to use

Pattern: ^[0-9a-fA-F]{32}$
token Required

string

The API token to use

Pattern: ^[0-9a-fA-F]{64}$
description

string

A string with a length from 0 to 16384.

Min length: 0, Max length: 16384
callbackURL Required

string

A valid URL that is reachable with a HEAD and POST request.

Format: url
idModel Required

string

ID of the model to be monitored

Pattern: ^[0-9a-fA-F]{32}$
active

boolean

Determines whether the webhook is active and sending POST requests.

Example

1
2
3
curl --request POST \
  --url 'https://api.trello.com/1/webhooks/?key=0471642aefef5fa1fa76530ce1ba4c85&token=9eb76d9a9d02b8dd40c2f3e5df18556c831d4d1fadbe2c45f8310e6c93b5c548&callbackURL={callbackURL}&idModel=5abbe4b7ddc1b351ef961414' \
  --header 'Accept: application/json'

Responses

Success

Content typeValue
application/json

Webhook

Get a Webhook

GET /1/webhooks/{id}

Get a webhook by ID.

Request

Path parameters
id Required

string

ID of the webhook to retrieve.

Pattern: ^[0-9a-fA-F]{32}$
Query parameters
key Required

string

The API key to use

Pattern: ^[0-9a-fA-F]{32}$
token Required

string

The API token to use

Pattern: ^[0-9a-fA-F]{64}$

Example

1
2
3
curl --request GET \
  --url 'https://api.trello.com/1/webhooks/{id}' \
  --header 'Accept: application/json'

Responses

Success

Content typeValue
application/json

Webhook

Update a Webhook

PUT /1/webhooks/{id}

Update a webhook by ID.

Request

Path parameters
id Required

string

ID of the webhook to retrieve.

Pattern: ^[0-9a-fA-F]{32}$
Query parameters
key Required

string

The API key to use

Pattern: ^[0-9a-fA-F]{32}$
token Required

string

The API token to use

Pattern: ^[0-9a-fA-F]{64}$
description

string

A string with a length from 0 to 16384.

Min length: 0, Max length: 16384
callbackURL

string

A valid URL that is reachable with a HEAD and POST request.

Format: url
idModel

string

ID of the model to be monitored

Pattern: ^[0-9a-fA-F]{32}$
active

boolean

Determines whether the webhook is active and sending POST requests.

Example

1
2
3
curl --request PUT \
  --url 'https://api.trello.com/1/webhooks/{id}?key=0471642aefef5fa1fa76530ce1ba4c85&token=9eb76d9a9d02b8dd40c2f3e5df18556c831d4d1fadbe2c45f8310e6c93b5c548' \
  --header 'Accept: application/json'

Responses

Success

Content typeValue
application/json

Webhook

Delete a Webhook

DELETE /1/webhooks/{id}

Delete a webhook by ID.

Request

Path parameters
id Required

string

ID of the webhook to retrieve.

Pattern: ^[0-9a-fA-F]{32}$
Query parameters
key Required

string

The API key to use

Pattern: ^[0-9a-fA-F]{32}$
token Required

string

The API token to use

Pattern: ^[0-9a-fA-F]{64}$

Example

1
2
curl --request DELETE \
  --url 'https://api.trello.com/1/webhooks/{id}'

Responses

Success

A schema has not been defined for this response code.

Get a field on a Webhook

GET /1/webhooks/{id}/{field}

Get a field on a Webhook

Request

Path parameters
id Required

string

ID of the webhook.

Pattern: ^[0-9a-fA-F]{32}$
field Required

string

Field to retrieve. One of: active, callbackURL, description, idModel

Valid values:Β active, callbackURL, description, idModel, consecutiveFailures, firstConsecutiveFailDate

Query parameters
key Required

string

The API key to use

Pattern: ^[0-9a-fA-F]{32}$
token Required

string

The API token to use

Pattern: ^[0-9a-fA-F]{64}$

Example

1
2
curl --request GET \
  --url 'https://api.trello.com/1/webhooks/{id}/{field}?key=0471642aefef5fa1fa76530ce1ba4c85&token=9eb76d9a9d02b8dd40c2f3e5df18556c831d4d1fadbe2c45f8310e6c93b5c548'

Responses

Success

A schema has not been defined for this response code.

Rate this page: