LINE Messaging API · error code

LINE error 403: Access to this API is not available for your account

Policy / accountHTTP 403403 / monthly quota: plan and permission limits

Last verified against LINE Developers - Messaging API reference (error responses)

What LINE returns
Access to this API is not available for your account

What error 403 means

Your credentials are fine - the request authenticated - but the thing you asked for is not enabled for your account. The status codes table describes 403 as: "Not authorized to access the resource. Confirm that your account or plan is authorized to access the resource," and the error messages table pins the body string: it "appears when calling an API that you do not have permission to use." That makes 403 categorically different from 401: no amount of token rotation fixes it, because the gate is entitlement, not identity.

Several Messaging API capabilities are gated in documented ways. Narrowcast targeting by attribute data requires your LINE Official Account's target reach to be at least 100 people - below that, the narrowcast endpoint returns 403 (its specific variant is covered at Not enough recipients). Audiences built on Identifiers for Advertisers (IFAs) are "only available to corporate users who have completed certain applications." Membership and some insight features depend on what your LINE Official Account has enabled. And because LINE Official Account subscription plans differ by country or region, a capability available to an account in one market may be absent in another - the docs are explicit that plans vary regionally, so verify against your region's plan pages rather than assuming parity.

The correct response to this error is administrative, not technical: identify which endpoint returned it, look up that endpoint's requirements in the reference, and either grow into the requirement (more friends for target reach), complete the application (IFA), or change the plan in LINE Official Account Manager. Retrying, or "fixing" request bodies, changes nothing - the same call succeeds from an account that has the entitlement and fails from yours.

What it looks like

HTTP/1.1 403 Forbidden

{
  "message": "Access to this API is not available for your account"
}

Why it happens

  • Calling a gated endpoint your account hasn't unlocked - e.g. IFA-based audience creation without the corporate application.
  • Narrowcast with attribute targeting while the account's target reach is below 100 people.
  • A feature not included in your LINE Official Account's plan or not offered in your country or region.
  • Using a channel whose LINE Official Account hasn't enabled the related feature (e.g. membership) in LINE Official Account Manager.
  • Calling an endpoint scoped to resources your account doesn't own or isn't authorized for.

How to fix LINE error 403

  1. 1Identify the exact endpoint that returned 403 and read its Error response section in the Messaging API reference for the documented entitlement.
  2. 2Check your account's plan and enabled features in LINE Official Account Manager, and your region's plan documentation - plans vary by country.
  3. 3For narrowcast 403s, check target reach in LINE Official Account Manager; attribute targeting needs at least 100.
  4. 4For IFA audiences, complete the corporate application through your sales representative or LINE's sales partners before retrying.
  5. 5If the entitlement should exist, contact LINE support quoting the X-Line-Request-Id of the failing call.

How to stop it recurring

Map the gated endpoints your product depends on before you build on them: note each one's documented requirement (target reach, corporate application, plan feature) and check it programmatically where possible - follower counts and quota are queryable via the API. Treat 403 as a terminal outcome in your retry logic and route it to an operations alert instead of a retry queue, since only an account-level change clears it. Regional plan differences deserve a launch-checklist line item; see monthly quota.

Official reference: LINE Developers - Messaging API reference (error responses). See all LINE error codes or the LINE limits and quotas.

Related codes

Error 403 - quick answers

What does LINE error 403 mean?

Your credentials are fine - the request authenticated - but the thing you asked for is not enabled for your account. The status codes table describes 403 as: "Not authorized to access the resource.

How do I fix LINE error 403?

1. Identify the exact endpoint that returned 403 and read its Error response section in the Messaging API reference for the documented entitlement. 2. Check your account's plan and enabled features in LINE Official Account Manager, and your region's plan documentation - plans vary by country. 3. For narrowcast 403s, check target reach in LINE Official Account Manager; attribute targeting needs at least 100. 4. For IFA audiences, complete the corporate application through…

Stop debugging LINE by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.