All integrations

Chatwork

MESSAGING · MESSAGING

Chats, messages, tasks, and files in the Chatwork account they connected.

Connecting Chatwork in practice

Chatwork runs two limiters: 300 requests per 5 minutes overall, and a separate 10 calls per 10 seconds on message posting and task creation, per room. The OAuth access token lives 30 minutes and the refresh token 14 days unless offline_access is requested, while the alternative API token never expires and carries the whole account.

Scopes that draw scrutiny

  • rooms.all:read_write Read and write across every room the user belongs to, rather than the one the agent was pointed at.
  • rooms.messages:write Posts messages as the authorizing user, which is the scope that makes an agent indistinguishable from the person in a group chat.
  • contacts.all:read_write Reads and modifies the user’s whole contact list, so it reaches people outside the rooms in scope.
  • users.all:read Reads all user information rather than only the authorizing user’s own profile.
  • offline_access Turns the 14-day refresh token into an indefinite one, which is the difference between a session and permanent access.

Rate limits

  • 300 requests per 5 minutes, reported through the x-ratelimit-remaining and x-ratelimit-reset response headers.
  • Message posting and task creation: 10 calls per 10 seconds. Over that, 429 with "Rate limit for message posting per room exceeded."

Worth knowing

  • OAuth access tokens expire after 30 minutes, so an agent doing anything long-running refreshes mid-task rather than at session start.
  • The two authentication modes have very different blast radius: an API token sent as x-chatworktoken has no expiry and full account access, while OAuth can be narrowed to rooms.messages:read.
  • Chatwork states the token must be sent in the HTTP request header and never in the URL query string.
  • Scope names distinguish rooms:write (create a room) from rooms.info:write and rooms.members:write, so "can it post" and "can it add people" are separate grants that neither implies.

Checked against Chatwork API endpoints and limits (2026-09-29), Chatwork OAuth (2026-09-29)

Acts as the person, not as itself

Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.

Credentials never touch the agent

Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.

Every call on the record

Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.

What an agent can do

Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.

chatwork_delete_incoming_requests_by_request_idWRITE

Decline a contact approval request. DELETE /v2/incoming_requests/{request_id}. Declines one pending contact approval request. The requester is not added as a contact. Chatwork's own wording: コンタクト承認依頼を拒否する 自分へのコンタクト承認依頼を拒否します。

api
chatwork_delete_rooms_by_room_idWRITE

Leave or delete a group chat. DELETE /v2/rooms/{room_id}. Leaves or deletes a group chat, and `action_type` decides which. Leaving deletes every task assigned to you and every file you uploaded in that chat; deleting removes the chat and all of its messages, tasks and files for every member. Both are irreversible. Chatwork's own wording: チャットを退席/削除する グループチャットを退席、または削除します。 グループチャットを退席すると、このグループチャットにある自分が担当者のタスク、および自分が送信したファイルがすべて削除されます。 グループチャットを削除すると、このグループチャットにあるメッセージ、タスク、ファイルがすべて削除されます。 （一度削除すると元に戻せません。）

api
chatwork_delete_rooms_by_room_id_linkWRITE

Delete a chat's invite link. DELETE /v2/rooms/{room_id}/link. Deletes the chat's invite link, so the URL stops admitting anyone. Returns 400 if the chat has no active invite link. Chatwork's own wording: チャットへの招待リンクを削除する チャットへの招待リンクを削除します。 招待リンクが無効になっている場合は400エラーを返します。

api
chatwork_delete_rooms_by_room_id_messages_by_message_idWRITE

Delete a message. DELETE /v2/rooms/{room_id}/messages/{message_id}. Deletes one message from a chat. Irreversible. Chatwork's own wording: チャットのメッセージを削除する チャットのメッセージを削除します。

api
chatwork_get_contactsREAD

List your contacts. GET /v2/contacts. Returns every account in the connected account's contact list, with each contact's account id, direct-chat room id, organization and avatar. Chatwork's own wording: コンタクト一覧を取得する 自分のコンタクト一覧を取得します。

api
chatwork_get_incoming_requestsREAD

List contact approval requests sent to you. GET /v2/incoming_requests. Returns up to 100 pending contact approval requests addressed to the connected account, each with its request id and the requesting account's profile. Chatwork's own wording: コンタクト承認依頼一覧を取得する 自分へのコンタクト承認依頼一覧を最大100件まで取得します。

api
chatwork_get_meREAD

Get your own account information. GET /v2/me. Returns the connected account's own profile: account id, Chatwork ID, display name, organization id and name, department, title, both email addresses, the three phone numbers, Skype/Facebook/Twitter handles and the avatar URL. Chatwork's own wording: 自分の情報を取得する 自分自身の情報を取得します。

api
chatwork_get_my_statusREAD

Get your unread and open-task counts. GET /v2/my/status. Returns three counters for the connected account: rooms with unread messages, rooms with an unread message addressed to them, and open tasks assigned to them. Cheap enough to poll, and the endpoint the credential probe uses. Chatwork's own wording: 自分の状態を取得する 自分の未読数、自分宛ての未読の数、未完了タスク数を取得します。

api
chatwork_get_my_tasksREAD

List the tasks assigned to you. GET /v2/my/tasks. Returns up to 100 tasks assigned to the connected account across every chat, each with its body, due date, status and the chat it belongs to. Filterable by who assigned it and by open/done status. Chatwork's own wording: 自分のタスク一覧を取得する 自分のタスク一覧を最大100件まで取得します。

api
chatwork_get_roomsREAD

List your chats. GET /v2/rooms. Returns every chat the connected account belongs to -- group chats, direct chats and My Chat -- with each chat's type, the account's role in it, unread and mention counts, and file and task counts. Chatwork's own wording: チャット一覧を取得する チャット一覧を取得します。

api
chatwork_get_rooms_by_room_idREAD

Get a chat's information. GET /v2/rooms/{room_id}. Returns one chat's name, description, icon, type, the connected account's role in it, its unread and mention counts, and its file and task counts. Chatwork's own wording: チャットの情報を取得する チャットの情報（名前、アイコン、種類など）を取得します。

api
chatwork_get_rooms_by_room_id_filesREAD

List a chat's files. GET /v2/rooms/{room_id}/files. Returns up to 100 files uploaded to one chat, each with its file id, uploader, name, size and the message it was posted with. Optionally filtered to one uploader. Chatwork's own wording: チャットのファイル一覧を取得する チャットのファイル一覧を最大100件まで取得します。

api
chatwork_get_rooms_by_room_id_files_by_file_idREAD

Get a chat file's information. GET /v2/rooms/{room_id}/files/{file_id}. Returns one file's name, size, uploader and message id. Pass `create_download_url=1` to also receive a download URL, which Chatwork says is valid for 30 seconds -- so fetch it at the moment you need it, not ahead of time. Chatwork's own wording: チャットのファイルの情報を取得する チャットのファイルの情報を取得します。

api
chatwork_get_rooms_by_room_id_linkREAD

Get a chat's invite link. GET /v2/rooms/{room_id}/link. Returns the chat's invite link: its code, full URL, description, and whether joining needs an administrator's approval. Chatwork's own wording: チャットへの招待リンクを取得する チャットへの招待リンクを取得します。

api
chatwork_get_rooms_by_room_id_membersREAD

List a chat's members. GET /v2/rooms/{room_id}/members. Returns every member of one chat with their account id, role (admin, member or readonly), organization and avatar. Chatwork's own wording: チャットのメンバー一覧を取得する チャットのメンバー一覧を取得します。

api
chatwork_get_rooms_by_room_id_messagesREAD

List a chat's messages. GET /v2/rooms/{room_id}/messages. Returns up to 100 messages from one chat. By default only messages newer than the previous call are returned, and an empty result means nothing new rather than an empty chat; pass `force=1` for the latest 100 regardless. Chatwork's own wording: チャットのメッセージ一覧を取得する チャットのメッセージ一覧を最大100件まで取得します。

api
chatwork_get_rooms_by_room_id_messages_by_message_idREAD

Get one message. GET /v2/rooms/{room_id}/messages/{message_id}. Returns a single message by id, with its author, body, send time and last-update time. Chatwork's own wording: チャットのメッセージを取得する チャットのメッセージを取得します。

api
chatwork_get_rooms_by_room_id_tasksREAD

List a chat's tasks. GET /v2/rooms/{room_id}/tasks. Returns up to 100 tasks in one chat, each with its body, assignee, assigner, due date and status. Filterable by assignee, by who assigned it, and by open/done status. Chatwork's own wording: チャットのタスク一覧を取得する チャットのタスク一覧を最大100件まで取得します。

api
chatwork_get_rooms_by_room_id_tasks_by_task_idREAD

Get a chat task. GET /v2/rooms/{room_id}/tasks/{task_id}. Returns one task's body, assignee, assigner, due date, due-date kind and completion status. Chatwork's own wording: チャットのタスクの情報を取得する チャットのタスクの情報を取得します。

api
chatwork_post_roomsWRITE

Create a group chat. POST /v2/rooms. Creates a new group chat and returns its room id. At least one administrator must be named in `members_admin_ids`, and every account named in any of the three member lists must already be a contact or in the same organization. Chatwork's own wording: グループチャットを作成する 新しいグループチャットを作成します。

api
chatwork_post_rooms_by_room_id_linkWRITE

Create a chat's invite link. POST /v2/rooms/{room_id}/link. Creates an invite link for the chat. Returns 400 if one already exists -- update it instead. Chatwork's own wording: チャットへの招待リンクを作成する チャットへの招待リンクを作成します。 すでに招待リンクが作成されている場合は400エラーを返します。

api
chatwork_post_rooms_by_room_id_messagesWRITE

Post a message to a chat. POST /v2/rooms/{room_id}/messages. Posts a new message and returns its message id. The body uses Chatwork's own message notation -- [To:<account_id>], [rp aid=...], [info], [title], [code] -- which is documented at https://developer.chatwork.com/docs/message-notation. Rate-limited to 10 posts per 10 seconds per chat, shared with task creation. Chatwork's own wording: チャットにメッセージを投稿する チャットに新しいメッセージを投稿します。

api
chatwork_post_rooms_by_room_id_tasksWRITE

Add a task to a chat. POST /v2/rooms/{room_id}/tasks. Creates a task in one chat, assigns it to every account named in `to_ids`, and returns the created task ids -- one per assignee. Rate-limited to 10 creations per 10 seconds per chat, shared with message posting. Chatwork's own wording: チャットにタスクを追加する チャットに新しいタスクを追加します。

api
chatwork_put_incoming_requests_by_request_idWRITE

Accept a contact approval request. PUT /v2/incoming_requests/{request_id}. Accepts one pending contact approval request; the requester becomes a contact and the response carries their profile. Chatwork's own wording: コンタクト承認依頼を承認する 自分へのコンタクト承認依頼を承認します。

api
chatwork_put_rooms_by_room_idWRITE

Update a chat's information. PUT /v2/rooms/{room_id}. Changes a chat's name, description or icon. Only the fields sent are changed. Chatwork's own wording: チャットの情報を変更する チャットの情報（名前、アイコンなど）を変更します。

api
chatwork_put_rooms_by_room_id_linkWRITE

Update a chat's invite link. PUT /v2/rooms/{room_id}/link. Changes an existing invite link's code, description or approval requirement. Returns 400 if the chat has no active invite link -- create one first. Chatwork's own wording: チャットへの招待リンクを変更する チャットへの招待リンクを変更します。 招待リンクが無効になっている場合は400エラーを返します。

api
chatwork_put_rooms_by_room_id_membersWRITE

Replace a chat's members. PUT /v2/rooms/{room_id}/members. Replaces the whole member list of one chat in a single call. This is not an add: an account missing from all three id lists is REMOVED from the chat, so send the full intended membership every time. Chatwork's own wording: チャットのメンバーを変更する チャットのメンバーを一括で変更します。

api
chatwork_put_rooms_by_room_id_messages_by_message_idWRITE

Update a message. PUT /v2/rooms/{room_id}/messages/{message_id}. Replaces the body of a message the connected account sent. Chatwork refuses another account's message. Chatwork's own wording: チャットのメッセージを更新する チャットのメッセージを更新します。

api
chatwork_put_rooms_by_room_id_messages_readWRITE

Mark a chat's messages as read. PUT /v2/rooms/{room_id}/messages/read. Marks messages up to and including `message_id` as read and returns the chat's remaining unread counters. Omitting `message_id` marks the whole chat read. Chatwork's own wording: チャットのメッセージを既読にする チャットのメッセージを既読にします。

api
chatwork_put_rooms_by_room_id_messages_unreadWRITE

Mark a chat's messages as unread. PUT /v2/rooms/{room_id}/messages/unread. Marks the chat unread from `message_id` onwards and returns the resulting unread counters. `message_id` is required here, unlike the read call. Chatwork's own wording: チャットのメッセージを未読にする チャットのメッセージを未読にします。

api
chatwork_put_rooms_by_room_id_tasks_by_task_id_statusWRITE

Change a task's completion status. PUT /v2/rooms/{room_id}/tasks/{task_id}/status. Marks one task open or done and returns its task id. Chatwork's own wording: チャットのタスクの完了状態を変更する チャットのタスクの完了状態を変更します。

api

Put Chatwork behind one governed endpoint.

Same permissions, same audit trail, whatever else you connect next.