Webhooks

About the Webhooks API

The EverTransit Webhooks API allows you to create a new webhook and delete an existing one. To make your requests, you can use the endpoints and their methods listed below.

Endpoints

• Create a webhook

• Delete a webhook

The Webhook object

{
  "id": "5f886c22fe5dd800318f8092",
  "events": [
    "ride_created"
  ],
  "endpoint": "https://myexample.com/mywebhook",
  "description": "My first webhook",
  "status": "active",
  "secret": "mysecret"
}

Attributes

Name	Type	Description
id	string	A unique identifier for the webhook.
events	array	A list of all the events that the webhook will subscribe to.
endpoint	string	A URL endpoint that will be called after the webhook receives any of the events it is subscribed to.
description	string	Brief description of the webhook functionality.
status	boolean	The status of the webhook. For example, active or disabled.
secret	string	A unique identifier used to identify webhook.

Create a webhook

Create a webhook.

post

Create a new webhook.

Authorizations

Body

eventsstring[]required

A list of all the events that the webhook will subscribe to.

Example: ride_created

endpointstring · urirequired

A URL endpoint that will be called after the webhook receives any of the events it is subscribed to.

Example: https://myexample.com/mywebhook

secretstringoptional

A unique identifier used to identify your webhook.

Example: my-secret

descriptionstringoptional

Brief description of the webhook functionality.

Example: My first webhook

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://endpoints.evertransit.com/v2beta/webhooks' \
  --header 'Content-Type: application/json' \
  --data '{
    "events": [
      "ride_created"
    ],
    "endpoint": "https://myexample.com/mywebhook",
    "secret": "my-secret",
    "description": "My first webhook"
  }'

200

400

401

200

{
  "id": "text",
  "events": [
    "text"
  ],
  "endpoint": "https://myexample.com/mywebhook",
  "description": "My first webhook",
  "status": "active",
  "secret": "my-secret"
}

The webhook was created successfully.

API playground for creating a webhook

Delete a webhook

Delete a webhook.

delete

Delete a webhook.

Authorizations

Path parameters

webhookIdstringrequired

A unique identifier for the webhook.

Example: ivan1qdJKrlURIBx7Rsj

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://endpoints.evertransit.com/v2beta/webhooks/{webhookId}'

200

401

404

200

{
  "id": "text",
  "events": [
    "text"
  ],
  "endpoint": "https://myexample.com/mywebhook",
  "description": "My first webhook",
  "status": "active",
  "secret": "my-secret"
}

The webhook was deleted successfully.

API playground for deleting a webhook