Releases: line/line-bot-sdk-python
v3.18.0 Add Coupon API Support to Messaging API
What's Changed
This release introduces Coupon API support to the Messaging API, enabling developers to create, manage, and deliver coupons directly through bot integrations. These new features mirror capabilities previously only available through the LINE Official Account Manager, offering greater flexibility in automating coupon workflows via the Messaging API.
✨ New API Endpoints
-
POST
/v2/bot/coupon
Create a new coupon, including metadata such as title, description, validity period, image URLs, acquisition conditions, and reward details (e.g., fixed-amount discounts). -
GET
/v2/bot/coupon
Retrieve a list of all coupons associated with your bot. -
GET
/v2/bot/coupon/{couponId}
Fetch detailed metadata of a specific coupon. -
PUT
/v2/bot/coupon/{couponId}
Mark a coupon as expired.
💬 Messaging API Enhancements
- Added support for a new message type:
type=coupon
You can now send coupons directly to users using the Messaging API, similar to sending text, image, or template messages.
📌 Example Use Cases
- Create a 1000 yen off coupon
- Send the coupon to a user using the new coupon message type
For detailed usage examples, see the official documentation.
📢 Official Announcement:
LINE Developers News — Coupon API Released (2025/08/06)
line-openapi updates
- chore(deps): update line-openapi digest to 3e09054 by @renovate[bot] in #808
- chore(deps): update line-openapi digest to 69a12e8 by @renovate[bot] in #811
- chore(deps): update line-openapi digest to 92f9320 by @renovate[bot] in #813
- Add Coupon API Support to Messaging API by @github-actions[bot] in #832
Dependency updates
- chore(deps): update actions/download-artifact action to v4.3.0 by @renovate[bot] in #805
- fix(deps): update dependency org.openapitools:openapi-generator to v7.13.0 by @renovate[bot] in #806
- chore(deps): update dependency tox to v4.26.0 by @renovate[bot] in #809
- chore(deps): update dependency org.codehaus.mojo:build-helper-maven-plugin to v3.6.1 by @renovate[bot] in #815
- chore(deps): update dependency pytest to v8.4.0 by @renovate[bot] in #814
- chore(deps): update dependency pytest-cov to v6.2.0 by @renovate[bot] in #816
- chore(deps): update dependency pytest-cov to v6.2.1 by @renovate[bot] in #817
- chore(deps): update dependency tox to v4.27.0 by @renovate[bot] in #818
- chore(deps): update dependency pytest to v8.4.1 by @renovate[bot] in #819
- fix(deps): update dependency org.openapitools:openapi-generator to v7.14.0 by @renovate[bot] in #820
- chore(deps): update dependency org.apache.maven.plugins:maven-enforcer-plugin to v3.6.0 by @renovate[bot] in #822
- chore(deps): update dependency org.apache.maven.plugins:maven-enforcer-plugin to v3.6.1 by @renovate[bot] in #826
- chore(deps): update dependency pytest-asyncio to v1.1.0 by @renovate[bot] in #827
- chore(deps): update dependency tox to v4.28.0 by @renovate[bot] in #828
- chore(deps): update dependency tox to v4.28.1 by @renovate[bot] in #829
- chore(deps): update dependency tox to v4.28.2 by @renovate[bot] in #830
- chore(deps): update dependency tox to v4.28.3 by @renovate[bot] in #831
- chore(deps): update dependency tox to v4.28.4 by @renovate[bot] in #833
- chore(deps): update actions/download-artifact action to v5 by @renovate[bot] in #834
Other Changes
- Improve issue triage and issue template by @eucyt in #812
- Update CONTRIBUTING.md to enhance development guidelines by @eucyt in #824
Full Changelog: v3.17.1...v3.18.0
v3.17.1 Fix type of CreateAudienceGroupResponse#expireTimestamp
What's Changed
Type for CreateAudienceGroupResponse#expireTimestamp
is not float or double, but integer actually. This release fixes type as bugfix.
- Fix type of expireTimestamp by @github-actions in #802
(original PR is line/line-openapi#106)
Dependency updates
Full Changelog: v3.17.0...v3.17.1
This release is prepared by @Yang-33
v3.17.0 Add includesOwnedAudienceGroups Parameter to Audience API
What's Changed
- Add includesOwnedAudienceGroups Parameter to Audience API by @github-actions in #800
Enhancement to Shared Audiences API
Support a new query parameter includesOwnedAudienceGroups
to the client.getSharedAudienceGroups
(GET /v2/bot/audienceGroup/shared/list
). This enhancement allows users to specify whether to include audience groups owned by the user in the response. It is especially useful for users who manage both shared and owned audience groups.
Specifications
- Added the
includesOwnedAudienceGroups
parameter to the API endpoint.- Type: Boolean
- Default: false
- Description:
true
: Include audience groups owned by the LINE Official Account Manager.false
: Respond only with audience groups shared by Business Manager.
Remove deprecated API
- Removed the
/v2/bot/audienceGroup/{audienceGroupId}/activate
and/v2/bot/audienceGroup/authorityLevel
endpoints.
Documents and Reference
For more information, please refer to the links provided above.
(original PR is line/line-openapi#105)
line-openapi updates
- Add type as required property in source object of webhook by @github-actions in #797
- chore(deps): update line-openapi digest to 954b163 by @renovate in #789
- chore(deps): update line-openapi digest to 0e669d0 by @renovate in #791
- chore(deps): update line-openapi digest to 31fa3c7 by @renovate in #795
Dependency updates
- chore(deps): update dependency tox to v4.25.0 by @renovate in #783
- chore(deps): update suzuki-shunsuke/pinact-action action to v0.2.2 by @renovate in #785
- chore(deps): update suzuki-shunsuke/pinact-action action to v1 by @renovate in #786
- chore(deps): update dependency org.apache.maven.plugins:maven-surefire-plugin to v3.5.3 by @renovate in #787
- chore(deps): update dependency pytest-cov to v6.1.0 by @renovate in #788
- chore(deps): update dependency pytest-cov to v6.1.1 by @renovate in #792
- chore(deps): update dependency wheel to v0.46.1 by @renovate in #796
- chore(deps): update actions/setup-node action to v4.4.0 by @renovate in #799
Other Changes
- Skip creating PR when only git submodule is updated by @Yang-33 in #784
- Remove deprecated link by @eucyt in #790
- Require more jobs in merge queue by @Yang-33 in #793
- Do not create another auto PR when a job runs for PR or merge queue by @Yang-33 in #798
Full Changelog: v3.16.3...v3.17.0
This release is prepared by @eucyt
v3.16.3 Fix response handling in audience group APIs
What's Changed
Note this patch is not related to sdk users. This release is just for our test. See https://github.com/line/line-bot-sdk-python/releases/tag/v3.16.2 about new features.
line-openapi updates
- chore(deps): update line-openapi digest to 9dec0f8 by @renovate in #770
- chore(deps): update line-openapi digest to cc542e3 by @renovate in #774
Dependency updates
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.18 by @renovate in #771
- chore(deps): update dependency pytest to v8.3.5 by @renovate in #775
- chore(deps): update dependency responses to v0.25.7 by @renovate in #776
- chore(deps): update dependency tox to v4.24.2 by @renovate in #778
Other Changes
- Support Python 3.13 by @Yang-33 in #768
- Add EoL and new release reminder by @Yang-33 in #769
- Pin commit hash of github actions to avoid supply chain attacks by @Yang-33 in #772
- Freeze package versions in requirements-*.txt by @habara-k in #755
- Grant minimum permissions to github acitons workflow jobs by @Yang-33 in #773
- Migrate renovate config by @Yang-33 in #782
Full Changelog: v3.16.2...v3.16.3
This release is prepared by @Yang-33
v3.16.2 Fix response handling in audience group APIs
What's Changed
- Modify http status code as response for manage-audience by @github-actions in #766
This change modifies the HTTP status code for the following audience group-related endpoints, as they were incorrect.
Some http status codes are wrong. They should be 202, not 200.
POST /v2/bot/audienceGroup/upload
(create_audience_group
)PUT /v2/bot/audienceGroup/upload
(add_audience_to_audience_group
)POST /v2/bot/audienceGroup/upload/byFile
(create_audience_for_uploading_userIds
)POST /v2/bot/audienceGroup/click
(create_click_based_audience_group
)POST /v2/bot/audienceGroup/imp
(create_imp_based_audience_group
)
NOTE: This change is not a modification of the messaging API itself. It is simply a correction of an error in sdk.
(original PR is line/line-openapi#87)
Other Changes
Full Changelog: v3.16.1...v3.16.2
This release is prepared by @Yang-33
v3.16.1 Support new Membership API and Webhook
What's Changed
Note this patch is not related to sdk users. See https://github.com/line/line-bot-sdk-python/releases/tag/v3.16.0 about new features.
Dependency updates
- chore(deps): update dependency org.apache.maven.plugins:maven-compiler-plugin to v3.14.0 by @renovate in #760
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.17 by @renovate in #761
- fix(deps): update dependency org.openapitools:openapi-generator to v7.12.0 by @renovate in #762
Full Changelog: v3.16.0...v3.16.1
This release is prepared by @Yang-33
v3.16.0 Support new Membership API and Webhook
What's Changed
- Support new Membership API and Webhook by @github-actions in #758
Support new Membership API and Webhook
We have implemented and supported new API and Webhook about Membership.
API to get a list of users who joined the membership
You can obtain a list of user IDs for users who have joined the membership of your LINE Official Account by calling client.getJoinedMembershipUsers(...)
.
Documents: https://developers.line.biz/en/reference/messaging-api/#get-membership-user-ids
Membership Webhook
We have introduced new Webhook events MembershipEvent
that indicates that a user has joined, left or renewed a membership of your LINE Official Account.
Documents: https://developers.line.biz/en/reference/messaging-api/#membership-event
For more details
For more details, check out the announcement: https://developers.line.biz/en/news/2025/02/13/membership-api/
(original PR is line/line-openapi#86)
Full Changelog: v3.15.0...v3.16.0
This release is prepared by @eucyt
v3.15.0 Support API of Shared Audiences in Business Manager
What's Changed
Add /v2/bot/audienceGroup/shared path by @github-actions in #757
Shared Audiences in Business Manager API Support
We have added and supported new API endpoints related to Shared Audiences in Business Manager.
API to Get Shared Audience Information
You can obtain detailed information about a specific audience shared in Business Manager by calling the endpoint:
- GET
https://api.line.me/v2/bot/audienceGroup/shared/{audienceGroupId}
API to Get List of Shared Audiences
You can acquire a list of audiences shared in Business Manager using the following endpoint:
- GET
https://api.line.me/v2/bot/audienceGroup/shared/list
By using the "Get Shared Audience Information" endpoint, you can retrieve more detailed data about each audience.
Documents and Reference
- News Announcement: Shared Audience Feature Release
- API Reference:
- Documentation on Audience Sharing: Using Audience Sharing
For more information, please refer to the links provided above.
(original PR is line/line-openapi#85)
line-openapi updates
Other Changes
Full Changelog: v3.14.5...v3.15.0
This release is prepared by @eucyt
v3.14.5 Remove obsolete GET /v2/bot/message/delivery/ad_phone
What's Changed
- Retire GET /v2/bot/message/delivery/ad_phone by @github-actions in #750
GET /v2/bot/message/delivery/ad_phone
was sunset.
This change removes it as it's no longer necessary to include it in line-openapi.
(original PR is line/line-openapi#82)
line-openapi updates
- Retire GET /v2/bot/message/delivery/ad_phone by @github-actions in #750
Dependency updates
Other Changes
- Fix renovate config for gitsubmodule by @Yang-33 in #748
- Fix double-quote handling in release creation workflow by @Yang-33 in #751
Full Changelog: v3.14.4...v3.14.5
v3.14.4 Remove obsolete feature: Audience Match
What's Changed
- Remove obsolete feature: Audience Match by @github-actions in #744
The Audience Match feature (/bot/ad/multicast/phone) was sunset in October 2023. This change removes it as it's no longer necessary to include it in line-openapi.
(original PR is line/line-openapi#80)
Dependency updates
Other Changes
- Rename generated-code.yml to generate-code.yml by @Yang-33 in #742
- Limit the timing of git submodule updates by renovate to avoid disrupting work during working hours by @Yang-33 in #743
Full Changelog: v3.14.3...v3.14.4
This release is prepared by @Yang-33