사이드 메뉴
Getting started
Kakao Developers
Login
Communication
Advertisement
- Concepts
- Ad creation: Ad account
- Ad creation: Campaign
- Ad creation: Ad group
- Targeting for ad group
- Custom audience targeting for ad group
- Ad creation: Creative common
- Ad creation: Display creative
- Ad creation: Message creative
- Ad creation: Personalized message creative
- Bizboard landing settings
- Report
- Message management
- Personalized message management
- Message ad management
- Message ad operation
- Ad View management
- Business Form linkage management
- Pixel & SDK linkage management
- Audience management
- Engagement targeting management
- Customer file management
- Friend group management
- Ad account management
- Reference
- Type information
- Error code
Concepts
This document introduces the features of the Talk Calendar APIs.
Talk Calendar is a service that allows you to quickly create schedules in Kakao Talk chat rooms and easily manage daily tasks by registering to-dos. By using the Talk Calendar API, your service can provide features to add and manage users’ calendars, schedules, and to-dos. Kakao Talk Channel managers can share schedules that include the Marketing area to further increase advertising effectiveness.

The Talk Calendar API can only be used by apps with the permission granted. For apps without permission or Test apps, only the app members can make calls, and the response range is restricted to those team members.
Refer to the steps below to request permission.
-
Configure the required consent items for each feature.
- Calendar, events: [Create, retrieve, update/delete Talk Calendar and events (
talk_calendar)]. - Tasks: [Create, retrieve, update/delete tasks in Talk Calendar (
talk_calendar_task)].
- Calendar, events: [Create, retrieve, update/delete Talk Calendar and events (
-
Implement features using the Talk Calendar API.
-
Verify that the features work properly for the app members.
-
Request permission in App management page > [App] > [Request additional features].
After getting permission, the Talk Calendar API will be available for all service users.
To use the public event feature of the Talk Calendar API, connect Kakao Talk Channel. Connecting the Kakao Talk channel is not required to apply for permissions, but it is recommended to set it before applying for permissions if possible.
On the web or app version of Talk Calendar, a user can see the user's calendar divided into three categories.
- [A] Talk Calendar
- [a] My Calendar
- [b] Sub-calendar
- [B] Shared Calendar
- Note: As of now, the Talk Calendar API does not support the Shared Calendar, which is created when a Team chat is created.
- [C] Subscribed calendar

Each calendar has the following features:
| Calendar type | Description | How to create a calendar |
|---|---|---|
| My Calendar ([A] > [a]) | Primary calendar that is automatically created when a user starts to use the Talk Calendar service. | My calendar is automatically created for each user. Note: This calendar cannot be deleted because it is set as a default calendar. |
| Sub-calendar ([A] > [b]) | Additional calendars that a user or a service has created. | A service can create a calendar through the Creating sub-calendar API. Users also can create a calendar in the Talk Calendar service. |
| Subscribed Calendar ([C]) | Calendar that Kakao Talk Channel publishes or manages to let users subscribe to the calendar based on interests. | A service can request to create a subscribed calendar at DevTalk. |
Here are the types of events that can be handled with the Talk Calendar APIs.
| Event type | Description | How to add | How to edit |
|---|---|---|---|
| Personal event | Events that a user has added to the user's My Calendar or sub-calendars | Users can create an event through the Creating event API. Note: The created event is added to a user's My Calendar or sub-calendars. | For event hosts, use the Editing event for host API. For event attendees, use the Editing event for attendee API. |
| Public event | Events that are published by a service's Kakao Talk Channel for marketing purpose | Your service can publish a public event through the Creating public event API. Users can add a public event published by your service to their own calendar by calling the Following public event API. Note: The public event is added to a user's My Calendar or sub-calendar. | Use the Editing event for attendee API. |
| Subscribed event | Events that are published by Kakao Talk Channel (Example: Kakao TV, Sports channel) | If a user subscribes to a subscribed calendar, all the events of the service are added to its subscribed calendar. If a user chooses to unsubscribe, all subscribed events are deleted. Note: The subscribed event is added to a user's Subscribed calendar. | Use the Editing event for attendee API. |
| Guest event | Public events that the user added to My calendar. Users cannot edit the original event but can edit the duplicated guest events. If Kakao Talk Channel edits the original public event, the changes also apply to the guest events. | - | - |
Calendar relationship

Users can write out the details of what they need to do and register it as a task. You can manage tasks to ensure they are completed without missing anything by setting up [Show My Challenge Record], where you can check time information and completion history as needed.
You can view, edit, or delete tasks. You cannot delete tasks registered on your Kakao Talk profile sticker.
If your service uses a public event or subscribed calendar, you can encourage users to add the event or calendar to their calendar by sending a Kakao Talk message through the Kakao Talk Share API or the Kakao Talk Message API. For this, you need to configure a message with a follow or subscribe button by using the calendar template.

To implement this functionality, see the following documentation:
| Purpose | Guide |
|---|---|
| To configure a calendar type of message | Message Template |
| To send a calendar message through Kakao Talk Share | JavaScript SDK Android SDK iOS SDK Flutter SDK |
| To send a calendar message through Kakao Talk Message Important: To send a calendar message to all users who are linked to your app, set consent items and request permission. | REST API JavaScript SDK Android SDK iOS SDK Flutter SDK |
Kakao API applies monthly and daily quotas for stable service. You can check the currently applied quota information in the Quota. To increase the applied quota limit, contact us as consultation and partnership are required.
To increase allocated quota for the Talk Calendar API, you need to request permission. By default, you can use the API on a limited quota for testing.
Refer to Scope of support to know whether each Kakao SDK supports each feature.
| API | Method | URL | Description |
|---|---|---|---|
| Retrieve list of calendars | GET | https://kapi.kakao.com/v2/api/calendar/calendars | Retrieves user's all calendars (My Calendar, sub-calendar, and subscribed calendar). |
| Create sub-calendar | POST | https://kapi.kakao.com/v2/api/calendar/create/calendar | Creates a sub-calendar on user's calendar under the Talk Calendar category. |
| Edit sub-calendar | POST | https://kapi.kakao.com/v2/api/calendar/update/calendar | Edits a particular sub-calendar. |
| Delete sub-calendar | DELETE | https://kapi.kakao.com/v2/api/calendar/delete/calendar | Deletes a particular sub-calendar. |
| Create event | POST | https://kapi.kakao.com/v2/api/calendar/create/event | Creates an event on a user's calendar. |
| Retrieve list of events | GET | https://kapi.kakao.com/v2/api/calendar/events | Retrieves all events (personal, public, or subscribed events) added on the requested calendar. |
| Retrieve details of event | GET | https://kapi.kakao.com/v2/api/calendar/event | Retrieves the details of a user's personal event. |
| Edit event for host | POST | https://kapi.kakao.com/v2/api/calendar/update/event/host | Edits a particular personal event that a user has created. |
| Delete event | DELETE | https://kapi.kakao.com/v2/api/calendar/delete/event | Deletes the user's personal event or public event added on a user's calendar. |
| Create public event | POST | https://kapi.kakao.com/v2/api/calendar/public/create/event | Creates a public event. |
| Retrieve list of public events | GET | https://kapi.kakao.com/v2/api/calendar/public/events | Retrieves all public events that your service has created. |
| Retrieve details of public event | GET | https://kapi.kakao.com/v2/api/calendar/public/event | Retrieves the details of a particular public event that your service has created. |
| Edit public event | POST | https://kapi.kakao.com/v2/api/calendar/public/update/event | Edits a particular public event. |
| Delete public event | DELETE | https://kapi.kakao.com/v2/api/calendar/public/delete/event | Deletes a particular public event. |
| Add public event to user calendar | POST | https://kapi.kakao.com/v2/api/calendar/public/follow | Adds public events published by your service's Kakao Talk Channel to a user's calendar. |
| Retrieve list of subscribable calendars | GET | https://kapi.kakao.com/v2/api/calendar/subscribable/calendars | Retrieves the list of the available calendars that a user can subscribe to. |
| Subscribe | POST | https://kapi.kakao.com/v2/api/calendar/subscribe | Subscribes to your service's calendar. |
| Unsubscribe | DELETE | https://kapi.kakao.com/v2/api/calendar/unsubscribe | Unsubscribes from your service's calendar. |
| Edit guest event | POST | https://kapi.kakao.com/v2/api/calendar/update/event/guest | Edits a particular public event or subscribed event added to a user's calendar. |
| Retrieve holidays and celebrations | GET | https://kapi.kakao.com/v2/api/calendar/holidays | Retrieves holidays in the Republic of Korea for a requested period on a calendar. |
| Create task | POST | https://kapi.kakao.com/v1/api/calendar/create/task | Creates a task. |
| Retrieve task | GET | https://kapi.kakao.com/v1/api/calendar/tasks | Retrieves a particular or list of task. |
| Check challenge record | GET | https://kapi.kakao.com/v1/api/calendar/task/records | Checks the challenge history of a specific recurring task. |
| Edit task | POST | https://kapi.kakao.com/v1/api/calendar/update/task | Edits a particular task. |
| Set completion status | POST | https://kapi.kakao.com/v1/api/calendar/complete/task | Sets the completion status of task. |
| Delete task | DELETE | https://kapi.kakao.com/v1/api/calendar/delete/task | Deletes a particular task. |