# Retries a failed webhook delivery POST {{baseURL}}/v2/webhooks/delivery-logs/{{endpointId}}/retry This endpoint manually retries a failed webhook delivery. This is a single try each time. It does not automatically retry multiple times. It does not interfere with or interrupt the normal retry procedures. See Also:
To list all available webhooks, see `GET /v2/webhooks/endpoints`.
To test a webhook, see `POST /v2/webhooks/endpoints/{{endpointId}}/ping`.
To list all available delivery logs, see `GET /v2/webhooks/delivery-logs` Endpoint: POST /v2/webhooks/delivery-logs/{deliveryLogId}/retry Version: V2 Beta Security: Bearer ## Path parameters: - `deliveryLogId` (string, required)
Specifies the delivery log identifier to retry. ## Response 200 fields (application/json): - `deliveryLogId` (string) Indicates the webhook delivery log identifier to retrieve. Example: 89a2c8d9-0e1f-4a2b-3c4d-5e6f7a8b9c25 Example: 89a2c8d9-0e1f-4a2b-3c4d-5e6f7a8b9c25 - `endpointId` (string) Indicates the webhook endpoint identifier. Example: 9ab3d9e0-1f2a-4b3c-4d5e-6f7a8b9c0d36 Example: 9ab3d9e0-1f2a-4b3c-4d5e-6f7a8b9c0d36 - `endpointName` (string) Indicates the display name for the webhook. This is a free-formed name that is convenient to recognize. Example: Peppared Street Cafe's Reconciliation Example: Peppared Street Cafe's Reconciliation - `endpointUrl` (string) Indicates the HTTPS callback URL that receives webhook events. Example: https://example.com/webhooks/pepparedstreetcafe Example: https://example.com/webhooks/pepparedstreetcafe - `eventId` (string) Indicates the event identifier. Example: 399f9d7d-0714-453c-9b6d-dda836e1d8e6 Example: 399f9d7d-0714-453c-9b6d-dda836e1d8e6 - `eventType` (string) Identifies events that are subscribed to. Valid values are: | Wire value | Meaning | Group | | --- | --- | --- | | api_key.created | An API key was created | API Keys (affiliate only) | | api_key.deleted | An API key was revoked or deleted | API Keys (affiliate only) | | invoice.created | A new invoice was created | Invoices | | invoice.paid | An invoice was marked as paid | Invoices | | merchant.created | A new merchant account was created | Merchants (affiliate only) | | payment_session.completed | A payment session reached a terminal state (completed, failed, or cancelled) | Payment Sessions | | payment_session.created | A payment session was created | Payment Sessions | | quick_payment.created | A quick payment link was created | Quick Payments | | quick_payment.paid | A quick payment link was paid | Quick Payments | | settlement.batch.completed | A batch settlement was processed and settled | Settlement | | subscription.created | A new subscription was created | Subscriptions | | subscription.delinquent | A subscription entered a delinquent state after repeated payment failures | Subscriptions | | subscription.paid | A subscription payment was successfully collected | Subscriptions | | subscription.payment_failed | A subscription payment attempt failed | Subscriptions | | terminal.added | A new terminal was registered to the account | Terminals | | terminal.deactivated | A terminal was deactivated on the account | Terminals | | terminal.out_of_paper | A terminal paper roll is empty | Terminals | | transaction.ach.cancelled | An ACH transaction was cancelled before processing | ACH Transactions | | transaction.ach.charged_back | An ACH transaction was returned or charged back | ACH Transactions | | transaction.ach.cleared | An ACH transaction successfully cleared | ACH Transactions | | transaction.ach.failed | An ACH transaction failed due to a processing error | ACH Transactions | | transaction.ach.held | An ACH transaction was placed on hold for review | ACH Transactions | | transaction.ach.in_progress | An ACH transaction was submitted to the network | ACH Transactions | | transaction.ach.refunded | An ACH transaction was refunded to the originator | ACH Transactions | | transaction.ach.scheduled | An ACH transaction was created and scheduled | ACH Transactions | | transaction.card.authorized | A card payment authorization was approved | Card Transactions | | transaction.card.captured | An authorized card payment was captured | Card Transactions | | transaction.card.declined | A card payment was declined by the issuer | Card Transactions | | transaction.card.failed | A card payment failed due to a processing error | Card Transactions | | transaction.card.refunded | A card payment was refunded to the cardholder | Card Transactions | | transaction.card.voided | A card authorization was voided before capture | Card Transactions | Examples: null [ "transaction.card.captured" ] [ "transaction.card.captured", "transaction.card.authorized" ] Enum: "api_key.created", "api_key.deleted", "invoice.created", "invoice.paid", "merchant.created", "payment_session.completed", "payment_session.created", "quick_payment.created", "quick_payment.paid", "settlement.batch.completed", "subscription.created", "subscription.delinquent", "subscription.paid", "subscription.payment_failed", "terminal.added", "terminal.deactivated", "terminal.out_of_paper", "transaction.ach.cancelled", "transaction.ach.charged_back", "transaction.ach.cleared", "transaction.ach.failed", "transaction.ach.held", "transaction.ach.in_progress", "transaction.ach.refunded", "transaction.ach.scheduled", "transaction.card.authorized", "transaction.card.captured", "transaction.card.declined", "transaction.card.failed", "transaction.card.refunded", "transaction.card.voided" - `deliveryLogStatus` (string) Indicates the webhook delivery log status. Valid values are: | Status | Explanation | | --- | --- | | Failure | The webhook delivery attempt did not succeed. | | Success | The webhook delivery attempt succeeded. | Example: Success Enum: "Success", "Failure" - `attemptNumber` (integer) Indicates the current delivery attempt number for the webhook. Example: 3 Example: 3 - `endpointHTTPResponseCode` (integer) Indicates the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Status | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 200 Example: 200 - `roundTripDurationMs` (integer) Indicates the round-trip duration (in milliseconds). Example: 367 Example: 367 - `errorMessage` (string) Indicates an error message if the delivery failed. Example: Recipient not available Example: Recipient not available - `createdOn` (string) Indicates the date-time (in an ISO 8601 UTC date-time format) the webhook was created on. Example: 2025-01-27T12:05:54.322Z Example: 2025-01-27T12:05:54.322Z - `nextRetryAt` (string) Indicates the timestamp (in an ISO 8601 date-time UTC format) of the next retry attempt. This value may be null if an attempt succeeded or there is no next retry attempt. Example: 2026-02-19T20:24:52.934Z Example: 2026-02-19T20:24:52.934Z ## Response 400 fields (application/json): - `details` (string) Indicates details about the error. Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Status | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) - `cause` (string) - `resolution` (string) - `documentationUrl` (string) https://developer.flute.com/ ## Response 401 fields (application/json): - `details` (string) Indicates details about the error. Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Status | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) - `cause` (string) - `resolution` (string) - `documentationUrl` (string) https://developer.flute.com/ ## Response 403 fields (application/json): - `details` (string) Indicates details about the error. Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Status | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) - `cause` (string) - `resolution` (string) - `documentationUrl` (string) https://developer.flute.com/ ## Response 404 fields (application/json): - `details` (string) Indicates details about the error. Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Status | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) - `cause` (string) - `resolution` (string) - `documentationUrl` (string) https://developer.flute.com/ ## Response 409 fields (application/json): - `details` (string) Indicates details about the error. Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Status | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) - `cause` (string) - `resolution` (string) - `documentationUrl` (string) https://developer.flute.com/ ## Response 429 fields (application/json): - `details` (string) Indicates details about the error. Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Status | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) - `cause` (string) - `resolution` (string) - `documentationUrl` (string) https://developer.flute.com/ ## Response 500 fields (application/json): - `details` (string) Indicates details about the error. Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error Example: Validation failed: -- Email: 'Email' is not a valid email address. Severity: Error - `statusCode` (integer) Specifies the HTTP response status code. This is the HTTP status code returned by the attempted delivery. The following is a list of HTTP response status codes that include but are not limited to: | HTTP Status | Meaning | | --- | --- | | 200 | Delivery succeeded | | 400 | Bad request | | 401 | Unauthorized | | 404 | Endpoint not found | | 429 | Rate limited | Example: 401 Example: 401 - `source` (string) Indicates the source of the error. Example: Example: - `exceptionType` (string) Indicates the error's exception type. Example: FluentValidation.ValidationException Example: FluentValidation.ValidationException - `correlationId` (string) Indicates the correlation identifier. Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef Example: aa6cfcd0-0295-4a4c-b074-8c901f114fef - `entityId` (string) Indicates the entity identifier. Example: null - `errorCode` (string) Indicates the error code. Example: null - `title` (string) - `cause` (string) - `resolution` (string) - `documentationUrl` (string) https://developer.flute.com/