Skip to main content

Errors

On failure, code is a machine-readable error code and message is a human-readable description.

codeHTTPDescription
OK200Success
VALIDATION_ERROR400Validation failed
TEMPLATE_VAR_MISSING400Missing template variable
INVALID_API_KEY401API Key/Secret invalid or disabled
MESSAGE_NOT_FOUND404Message not found
TEMPLATE_NOT_FOUND404Template missing or not approved
CUSTOMER_NOT_BOUND409Customer not bound to LINE
CUSTOMER_UNFOLLOWED409Customer hasn't added the OA as a friend; cannot push
IDEMPOTENCY_CONFLICT409Same idempotency key but different payload
QUOTA_EXCEEDED429Monthly message quota used up
INTERNAL_ERROR500Server error

Error response example

{
"code": "CUSTOMER_NOT_BOUND",
"message": "Customer not bound to LINE",
"requestId": "req_...",
"data": null
}

Handling tips

  • CUSTOMER_NOT_BOUND / CUSTOMER_UNFOLLOWED: guide the customer to complete LINE binding / add the OA as a friend.
  • QUOTA_EXCEEDED: contact the platform to upgrade the plan or wait for the next billing cycle.
  • INVALID_API_KEY: verify the key/secret and that it isn't disabled.
  • Include the requestId from the response when reporting an issue.