Webhooks | Tradevest

Get All Webhooks

get

/webhooks

Get information about existing webhooks.

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Responses

200

OK

application/json

get

/webhooks

GET /webhooks HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

OK

[
  {
    "createdOn": "2019-08-24T14:15:22Z",
    "modifiedOn": "2019-08-24T14:15:22Z",
    "eventType": "CUSTOMER_NOTIFICATION",
    "url": "https://client-address.de/e9c1a702ccab"
  },
  {
    "createdOn": "2019-08-24T14:15:22Z",
    "modifiedOn": "2019-08-24T14:15:22Z",
    "eventType": "DOCUMENT_NOTIFICATION",
    "url": "https://client-address.de/2de0d16efb49",
    "headers": [
      {
        "name": "api-key",
        "value": "secret-api-key"
      }
    ]
  }
]

Create or Update Webhook

post

/webhooks

Create webhook, replacing the webhook for this event type if one already exists. It is possible to create only one webhook per event.

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Body

eventTypestring · enumRequiredPossible values:

urlstringRequired

The URL must be HTTPS.

Responses

200

OK

No content

400

Bad Request

application/json

post

/webhooks

POST /webhooks HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 140

{
  "eventType": "CUSTOMER_NOTIFICATION",
  "url": "https://client-address.de/e9c1a702ccab",
  "headers": [
    {
      "name": "api-key",
      "value": "secret-api-key"
    }
  ]
}

No content

Delete Webhook

delete

/webhooks/{eventType}

Delete webhook with given eventType.

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

eventTypestringRequired

Event type of webhook.

Responses

200

Webhook deleted

No content

delete

/webhooks/{eventType}

DELETE /webhooks/{eventType} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

Webhook deleted

No content

Get Webhook

get

/webhooks/{eventType}

Get webhook by eventType.

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Path parameters

eventTypestringRequired

Event type of webhook.

Responses

200

OK

application/json

404

Not Found

application/json

get

/webhooks/{eventType}

GET /webhooks/{eventType} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "createdOn": "2025-12-23T06:05:23.247Z",
  "modifiedOn": "2025-12-23T06:05:23.247Z",
  "eventType": "CUSTOMER_NOTIFICATION",
  "url": "text",
  "headers": [
    {
      "name": "text",
      "value": "text"
    }
  ]
}

Get All Missing Webhooks

get

/webhooks-missing

Get all missing webhooks. This is an auxiliary endpoint to help avoid situations where a notification could be missed.

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Responses

200

OK

application/json

get

/webhooks-missing

GET /webhooks-missing HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

OK

[
  {
    "eventType": "CUSTOMER_NOTIFICATION"
  }
]

Get Undelivered Webhooks

get

/undelivered-webhooks

Get undelivered webhooks to retry sending them. Undelivered webhooks will be kept in database for 30 days. After this time they may be removed. It is an auxiliary endpoint that helps to find webhooks that have not been delivered.

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Query parameters

limitinteger · min: 1Optional

Maximum number of items to return

Default: 20Example: 20

cursorstringOptional

String value used for pagination

startDatestring · date-timeOptional

Beginning of the range. Date time is after this parameter.

Example: 2019-04-12T23:20:50.52Z

endDatestring · date-timeOptional

End of the range. Date time is before this parameter.

Example: 2019-05-12T23:20:50.52Z

eventTypestring · enumOptional

Event type of webhook.

Possible values:

Responses

200

OK

application/json

get

/undelivered-webhooks

GET /undelivered-webhooks HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

OK

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "webhook": {
        "createdOn": "2025-12-23T06:05:23.247Z",
        "modifiedOn": "2025-12-23T06:05:23.247Z",
        "eventType": "CUSTOMER_NOTIFICATION",
        "url": "text",
        "headers": [
          {
            "name": "text",
            "value": "text"
          }
        ]
      },
      "body": "text",
      "errorMessage": "text",
      "createdOn": "2025-12-23T06:05:23.247Z",
      "modifiedOn": "2025-12-23T06:05:23.247Z"
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}

Mark Delivered Webhooks

post

/undelivered-webhooks

Mark the webhook with the specified id and all previous ones as delivered. They will no longer appear in the Get Undelivered Webhooks response.

Authorizations

OAuth2clientCredentialsRequired

Token URL:

Body

undeliveredWebhookIdstring · uuidRequired

Id of the newest undelivered webhook to be marked as delivered. All older webhooks will also be marked.

Responses

200

OK

No content

post

/undelivered-webhooks

POST /undelivered-webhooks HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "undeliveredWebhookId": "123e4567-e89b-12d3-a456-426614174000"
}

200

OK

No content