Create a webhook endpoint

Creates an active HTTPS endpoint that receives the subscribed event types, and returns the endpoint with its signing secret. Keep the secret, because read operations do not return it. Send an Idempotency-Key header. An application can have at most 25 endpoints.

POST/api/v2/developer/apps/{appId}/webhook-endpoints

Parameters #

PropertyTypeLocationDescription
appIdstringRequiredpath-
x-request-idstringheader-
idempotency-keystringRequiredheader-

Request #

curl --request POST 'https://strave.gg/api/v2/developer/apps/APP_ID/webhook-endpoints' \
  --header 'Authorization: Bearer $STRAVE_ACCESS_TOKEN'

Response #

201Response for status 201
application/json
400Response for status 400
application/json
401Response for status 401
application/json
403Response for status 403
application/json
404Response for status 404
application/json
409Response for status 409
application/json
412Response for status 412
application/json
428Response for status 428
application/json
429Response for status 429
application/json
500Response for status 500
application/json
503Response for status 503
application/json
PropertyTypeDescription
dataobjectRequired-
└endpointobjectRequired-
└idstringRequired-
└applicationIdstringRequired-
└namestringRequired-
└descriptionstring | nullRequired-
└urlstringRequired-
└subscribedEventsstring[]Required-
└statusstringRequired-
└revisionintegerRequired-
└createdAtstringRequired-
└updatedAtstringRequired-
└secretstringRequired-