Actions
    Applications
    Batch
    Boards
    Cards
    Checklists
    CustomFields
    Emoji
    Enterprises
    Labels
    Lists
    Members
    Notifications
    Organizations
    Plugins
    Search
    Tokens
    Webhooks

    Rate this page:

    Webhooks

    Create a Webhook

    POST /1/webhooks/

    Create a new webhook.

    Request

    Query parameters
    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]{24}$
    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/?callbackURL={callbackURL}&idModel=5abbe4b7ddc1b351ef961414&key=APIKey&token=APIToken' \
      --header 'Accept: application/json'

    Responses

    Success

    Content typeValue
    application/json

    Webhook

    Get a Webhook

    GET /1/webhooks/{id}

    Get a webhook by ID. You must use the token query parameter and pass in the token the webhook was created under, or else you will encounter a 'webhook does not belong to token' error.

    Request

    Path parameters
    id Required

    string

    ID of the webhook to retrieve.

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

    Example

    1
    2
    3
    curl --request GET \
      --url 'https://api.trello.com/1/webhooks/{id}?key=APIKey&token=APIToken' \
      --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]{24}$
    Query parameters
    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]{24}$
    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=APIKey&token=APIToken' \
      --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]{24}$

    Example

    1
    2
    curl --request DELETE \
      --url 'https://api.trello.com/1/webhooks/{id}?key=APIKey&token=APIToken'

    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]{24}$
    field Required

    string

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

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

    Example

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

    Responses

    Success

    A schema has not been defined for this response code.

    Rate this page: