Error codes · PostBuddy Developers

Every error answers application/problem+json (RFC 9457) with a stable code, a human title and detail, optional field errors and the requestId to quote to support. The type is the address of the code's page on this site.

JSON

{
  "type": "https://docs.postbuddy.nl/errors/validation_failed",
  "title": "Validation failed",
  "status": 422,
  "code": "validation_failed",
  "detail": "The request body is invalid",
  "errors": [
    {
      "field": "name",
      "code": "too_small",
      "message": "String must contain at least 1 character(s)"
    }
  ],
  "requestId": "req_01J…"
}

Codes

Code	Status	Title
`organisation_context_required`	400	Organisation header required
`api_key_invalid`	401	API key invalid
`api_key_revoked`	401	API key revoked
`authentication_required`	401	Authentication required
`credit_limit_reached`	402	Credit limit reached
`insufficient_balance`	402	Insufficient balance
`admin_permission_required`	403	Console permission required
`allowance_exceeded`	403	Allowance exceeded
`blocked_in_support_session`	403	Blocked in support session
`csrf_failed`	403	Cross-site request refused
`feature_not_entitled`	403	Feature not entitled
`insufficient_scope`	403	Insufficient scope
`integration_disabled`	403	Integration disabled
`invitation_email_mismatch`	403	Invitation was sent to another email address
`mfa_enrolment_required`	403	Second factor enrolment required
`organisation_suspended`	403	Organisation suspended
`permission_denied`	403	Permission denied
`postflow_limit_reached`	403	Postflow limit reached
`product_not_entitled`	403	Product not entitled
`step_up_required`	403	A fresh second factor code is required
`not_found`	404	Not found
`already_member`	409	Already a member of this organisation
`asset_in_use`	409	Asset in use
`folder_not_empty`	409	Folder not empty
`idempotency_in_progress`	409	Request with this idempotency key in progress
`invalid_item_transition`	409	Invalid item transition
`invalid_postbatch_transition`	409	Invalid Postbatch transition
`invitation_pending`	409	An invitation for this email is already pending
`item_locked_for_production`	409	Item locked for production
`last_owner`	409	The last Owner cannot be removed or demoted
`last_super_admin`	409	The last Super admin cannot be disabled, removed or demoted
`postflow_archived`	409	Postflow archived
`product_activation_blocked`	409	Product activation blocked
`specification_immutable`	409	Specification version is immutable
`still_referenced`	409	Still referenced
`template_archived`	409	Template archived
`template_in_use`	409	Template in use
`ticket_closed`	409	Ticket closed
`upload_incomplete`	409	Upload not completed
`invitation_expired`	410	Invitation expired or withdrawn
`draft_conflict`	412	Draft was modified elsewhere
`import_too_large`	413	Import too large
`upload_too_large`	413	Upload too large
`base_template_violation`	422	Base template rules broken
`destination_not_supported`	422	Destination not supported
`idempotency_key_reused`	422	Idempotency key reused with a different body
`image_url_not_allowed`	422	Image URL not allowed
`import_invalid_file`	422	Import file invalid
`item_render_failed`	422	Item could not be rendered
`mapping_incomplete`	422	Mapping incomplete
`upload_rejected`	422	Upload rejected
`validation_failed`	422	Validation failed
`variable_name_conflict`	422	Variable names conflict
`rate_limited`	429	Rate limited
`internal_error`	500	Internal error
`service_unavailable`	503	Service unavailable
`vies_unavailable`	503	VAT validation service unavailable

Warning codes on items

Items that need attention carry one or more of these codes.

address_invalid
postal_code_invalid
house_number_missing
city_missing
country_not_supported
destination_not_supported
variable_missing
variable_type_invalid
variable_too_long
image_fetch_failed
image_resolution_low
text_overflow
expression_invalid
late_delivery_expected
waiting_for_funds
suppressed
carrier_codes_missing
excluded_from_run