Delivery

Send a test delivery

Queues a signed destination.test delivery through the normal delivery path. Poll the delivery for its receipt.

post/v1/destinations/{destination_id}:test

Request

  • Base URL: https://sourcefinch.com
  • URL: https://sourcefinch.com/v1/destinations/{destination_id}:test
  • Auth: HTTP bearer

Path parameters

destination_idstring uuid required

Headers

Idempotency-Keystring

Makes retries safe for 24 hours. Reusing a key with a different request returns 422.

X-Request-Idstring

Echoed in the response and logs; generated when absent.

SourceFinch-Projectstring uuid

Project UUID. Required for session tokens; API keys are bound to their project.

Request body

object required

Empty body. Send an Idempotency-Key header to make retries safe.

Response

The queued test delivery

idstring uuid required
destination_idstring uuid required
run_idstring uuid nullable required
source_idstring uuid nullable required
testboolean required
idempotency_keystring required
status'pending' | 'in_flight' | 'delivered' | 'dead' | 'cancelled' required
attemptsinteger required
next_attempt_atstring required

ISO-8601 timestamp (UTC)

payload_sha256string nullable required
last_status_codeinteger nullable required
last_errorstring nullable required
last_attempt_atstring nullable required

ISO-8601 timestamp (UTC)

delivered_atstring nullable required

ISO-8601 timestamp (UTC)

created_atstring required

ISO-8601 timestamp (UTC)

Changes

No recorded changes to this operation across all 2 revisions of this API.