Skip to main content

A refused request

A refusal before payment is never charged. It has a non-2xx status:
Branch on error. message may change. details is optional. GET /v1/submissions/recover answers 404 submission_not_found with acceptance: unknown when it has no record of the key. Timeouts and retries says when submitting with that key is safe.

A failed job

GET /v1/requests/{request_id} answers 200 with:
Branch on error_code. error may change. LinkedIn failures put reason in result, plus upstream_reason, LinkedIn’s own error type, when it gave one. The TypeScript SDK throws a JobError with code and partialResult.

Categories

Unlisted codes are internal. See also job status.

LinkedIn codes

For invite, withdraw, message and reply. Terminal: the same request cannot succeed. Retryable: it can, later. Retry with a new Idempotency-Key. The same key never sends again.

Unconfirmed sends and refunds

A timeout, server error or throttled send may still have reached LinkedIn. The job stays processing with send_status: "ambiguous" while OneShot checks, then reports send_unverified after 24 hours. It is not refunded, unless a throttled invitation is shown not to have been sent. A request that fails before reaching LinkedIn is refunded as account credit within a day; refunds run daily at 03:00 UTC. The receipt gets a new signed revision marked failed.