How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

LINE Messaging API Webhook

The inbound event surface of the Messaging API, published by LINE as an OpenAPI type-definition document. LINE delivers CallbackRequest envelopes to the bot server's configured HTTPS endpoint, carrying an events[] array of 20+ polymorphic event types (message, follow, unfollow, join, leave, postback, beacon, accountLink, membership, videoPlayComplete and others) over 60 component schemas. Every delivery is signed with a Base64 HMAC-SHA256 of the raw body in the x-line-signature header.

LINE Messaging API Webhook is one of 10 APIs that LINE publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Webhook and Event. The published artifact set on APIs.io includes an OpenAPI specification, an AsyncAPI specification, and API documentation.

This API exposes 1 operation across 1 path, and defines 60 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://example.com.

1 operations 1 paths 60 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.line.me
Resource Areas
1

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

dummy 1
POST
/callback
This is the dummy endpoint to generate the model classes
callback body → 200

Schemas 60

The contract defines 60 schemas that model the data the API accepts and returns. The most detailed are Event (6 properties), Emoji (4 properties), BeaconContent (3 properties), Mentionee (3 properties). Each schema is shown below with its type and property counts.

CallbackRequest
object
The request body contains a JSON object with the user ID of a bot that should receive webhook events and an array of webhook event objects.
2 properties 2 required
Event
object
Webhook event
6 properties 5 required
EventMode
string
Channel state.
DeliveryContext
object
webhook's delivery context information
1 property 1 required
Source
object
the source of the event.
1 property 1 required
UserSource
GroupSource
RoomSource
MessageEvent
object
Webhook event object which contains the sent message.
MessageContent
object
2 properties 2 required
ContentProvider
object
Provider of the media file.
3 properties 1 required
TextMessageContent
Emoji
object
4 properties 4 required
Mention
object
1 property 1 required
Mentionee
object
3 properties 3 required
UserMentionee
Mentioned target is user
AllMentionee
Mentioned target is entire group
ImageMessageContent
ImageSet
object
3 properties 1 required
VideoMessageContent
AudioMessageContent
FileMessageContent
LocationMessageContent
StickerMessageContent
UnsendEvent
Event object for when the user unsends a message.
UnsendDetail
object
1 property 1 required
FollowEvent
Event object for when your LINE Official Account is added as a friend (or unblocked). You can reply to follow events.
FollowDetail
object
1 property 1 required
UnfollowEvent
Event object for when your LINE Official Account is blocked.
JoinEvent
Event object for when your LINE Official Account joins a group chat or multi-person chat. You can reply to join events.
LeaveEvent
Event object for when a user removes your LINE Official Account from a group chat or when your LINE Official Account leaves a group chat or multi-person chat.
MemberJoinedEvent
Event object for when a user joins a group chat or multi-person chat that the LINE Official Account is in.
JoinedMembers
object
1 property 1 required
MemberLeftEvent
Event object for when a user leaves a group chat or multi-person chat that the LINE Official Account is in.
LeftMembers
object
1 property 1 required
PostbackEvent
Event object for when a user performs a postback action which initiates a postback. You can reply to postback events.
PostbackContent
object
2 properties 1 required
VideoPlayCompleteEvent
Event for when a user finishes viewing a video at least once with the specified trackingId sent by the LINE Official Account.
VideoPlayComplete
object
1 property 1 required
BeaconEvent
Event object for when a user enters the range of a LINE Beacon. You can reply to beacon events.
BeaconContent
object
3 properties 2 required
AccountLinkEvent
Event object for when a user has linked their LINE account with a provider's service account. You can reply to account link events.
LinkContent
object
Content of the account link event.
2 properties 2 required
MembershipEvent
This event indicates that a user has subscribed (joined), unsubscribed (left), or renewed the bot's membership.
MembershipContent
object
Content of the membership event.
1 property 2 required
JoinedMembershipContent
LeftMembershipContent
RenewedMembershipContent
ModuleEvent
This event indicates that the module channel has been attached to the LINE Official Account. Sent to the webhook URL server of the module channel.
ModuleContent
object
1 property 1 required
AttachedModuleContent
DetachedModuleContent
ActivatedEvent
This event indicates that the module channel has been switched to Active Channel by calling the Acquire Control API. Sent to the webhook URL server of the modu…
ChatControl
object
1 property 1 required
DeactivatedEvent
This event indicates that the module channel has been switched to Standby Channel by calling Acquire Control API or Release Control API. Sent to the webhook UR…
BotSuspendedEvent
This event indicates that the LINE Official Account has been suspended (Suspend). Sent to the webhook URL server of the module channel.
BotResumedEvent
This event indicates that the LINE Official Account has returned from the suspended state. Sent to the webhook URL server of the module channel.
PnpDeliveryCompletionEvent
When a request is made to the LINE notification messages API and delivery of the LINE notification message to the user is completed, a dedicated webhook event…
PnpDelivery
object
A delivery object containing a hashed phone number string or a string specified by X-Line-Delivery-Tag header
1 property 1 required
MessageEditedEvent
object
Webhook event object which contains the edited message. This event is triggered when a user edits a text message. Currently, message editing is not available i…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

line-webhook-openapi.yml Raw ↑

Other APIs LINE publishes across the network.

LINE Messaging API
LINE Channel Access Token API
LINE Insight API
LINE Manage Audience API
LIFF Server API
LINE Module API
LINE Module Attach API
LINE Mission Sticker API
LINE Login v2.1
Where this information came from

This is an independent, third-party profile of LINE Messaging API Webhook, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.