# Messaging API reference
# Common specifications
Common specifications for Messaging API, such as the domain name of endpoints, response when a request succeeds or fails, and rate limit.
# Webhooks
When an event occurs, such as when a user adds your LINE Official Account as a friend or sends a message, the LINE Platform sends an HTTPS POST request to the webhook URL (bot server).
The webhook URL is configured for each channel in the LINE Developers Console.
# Webhook Event Objects
These are JSON objects containing events generated by the LINE Platform.
# Webhook settings
You can configure, test, and get information on channel webhook endpoints.
# Channel access token
You can issue, get, or revoke the channel access token required when calling the Messaging API from the app.
# Message
You can send a message and obtain information about the sent message.
POST
/v2/bot/message/reply
POST
/v2/bot/message/push
POST
/v2/bot/message/multicast
POST
/v2/bot/message/narrowcast
GET
/v2/bot/message/progress/narrowcast
POST
/v2/bot/message/broadcast
GET
/v2/bot/message/quota
GET
/v2/bot/message/quota/consumption
GET
/v2/bot/message/delivery/reply
GET
/v2/bot/message/delivery/push
GET
/v2/bot/message/delivery/multicast
GET
/v2/bot/message/delivery/broadcast
POST
/v2/bot/message/validate/reply
POST
/v2/bot/message/validate/push
POST
/v2/bot/message/validate/multicast
POST
/v2/bot/message/validate/narrowcast
POST
/v2/bot/message/validate/broadcast
GET
/v2/bot/message/aggregation/info
GET
/v2/bot/message/aggregation/list
# Managing Audience
You can create, update, activate, or delete an audience. Specify the audience when sending narrowcast messages.
POST
/v2/bot/audienceGroup/upload
POST
/v2/bot/audienceGroup/upload/byFile
PUT
/v2/bot/audienceGroup/upload
PUT
/v2/bot/audienceGroup/upload/byFile
POST
/v2/bot/audienceGroup/click
POST
/v2/bot/audienceGroup/imp
PUT
/v2/bot/audienceGroup/{audienceGroupId}/updateDescription
PUT
/v2/bot/audienceGroup/{audienceGroupId}/activate
DELETE
/v2/bot/audienceGroup/{audienceGroupId}
GET
/v2/bot/audienceGroup/{audienceGroupId}
GET
/v2/bot/audienceGroup/list
GET
/v2/bot/audienceGroup/authorityLevel
PUT
/v2/bot/audienceGroup/authorityLevel
# Insight
You can obtain information on the number of messages sent from the LINE Official Account, number of friends, and other statistical data.
# Users
You can get information of users who have added your LINE Official Account as a friend.
You can access your user ID under the Basic settings tab of your channel on the LINE Developers Console. For more information on permissions per role in the LINE Developers Console, see Channel roles in Managing roles. There is no API available for retrieving your own user ID.
# Bot
You can obtain basic information on the LINE Official Account's bots.
# Group chats
You can obtain information about the group chats and their members that the LINE Official Account is a member of.
# Multi-person chats
You can obtain information about the multi-person chats and their members that the LINE Official Account is a member of.
# Rich menu
Customizable menu that is displayed on your LINE Official Account's chat screen. For more information, see Using rich menus.
POST
/v2/bot/richmenu
POST
/v2/bot/richmenu/validate
POST
/v2/bot/richmenu/{richMenuId}/content
GET
/v2/bot/richmenu/{richMenuId}/content
GET
/v2/bot/richmenu/list
GET
/v2/bot/richmenu/{richMenuId}
DELETE
/v2/bot/richmenu/{richMenuId}
POST
/v2/bot/user/all/richmenu/{richMenuId}
GET
/v2/bot/user/all/richmenu
DELETE
/v2/bot/user/all/richmenu
POST
/v2/bot/richmenu/alias
DELETE
/v2/bot/richmenu/alias/{richMenuAliasId}
POST
/v2/bot/richmenu/alias/{richMenuAliasId}
GET
/v2/bot/richmenu/alias/{richMenuAliasId}
GET
/v2/bot/richmenu/alias/list
POST
/v2/bot/user/{userId}/richmenu/{richMenuId}
POST
/v2/bot/richmenu/bulk/link
GET
/v2/bot/user/{userId}/richmenu
DELETE
/v2/bot/user/{userId}/richmenu
POST
/v2/bot/richmenu/bulk/unlink
# Account link
You can link the service account provided by the provider (corporate and developer) with the account of the LINE user.
# Message objects
JSON object which contains the contents of the message you send.
By using the following endpoints, you can validate message objects:
# Action objects
These are types of actions for your bot to take when a user taps a button or an image in a message.
# Rich menu structure
Rich menus consist of either of these objects.
- Rich menu object without the rich menu ID. Use this object when you create a rich menu.
- Rich menu response object with the rich menu ID. This object is returned when you get a rich menu or get a list of rich menus.
Area objects and action objects are included in these objects.