monday.com Integration

Use the monday.com integration when your team manages work in monday.com but keeps time, approvals, budgets, reports, and billing in Keito. An administrator maps monday.com boards or individual items to Keito projects and tasks. Members can then search their accessible monday.com items and attach one as a verified reference while recording time in Keito.

The integration is available to every Keito Business workspace. No beta invitation or workspace enablement is needed. A Keito owner or administrator makes the first connection, then each person links their own monday.com account. Reference linking is read-only by default. Time copying is off by default and requires separate administrator authorization and column settings.

At a glance

	monday.com with Keito
Connection	One monday.com account for the whole Keito workspace, plus a personal connection for each member
Set up by	Keito owner or administrator
Everyday data flow	Accessible mapped monday.com items are read when needed; the selected reference is saved with a Keito time entry
monday.com writes	None by default; optional recorded-hour totals in a dedicated Numbers column
Keito plan	Business
Supported items	Classic top-level items and same-board nested items on Project-format multi-level boards

What the integration does

• Lets an owner or administrator bind one monday.com account to one Keito workspace.
• Lets every member connect their own monday.com identity, preserving monday.com’s board permissions as the access boundary.
• Maps a monday.com board to one active Keito project and an active task assigned to that project.
• Lets an exact item mapping override its board mapping.
• Adds an optional monday.com item search to Keito time-entry forms.
• Automatically selects the mapped Keito project and task when a member chooses an item.
• Verifies the member’s access, item, hierarchy, and current mapping again when the entry is saved.
• Stores the selected item’s name, board, URL, and stable reference with the Keito time entry.
• Keeps saved reference details visible if the source is renamed, becomes inaccessible, or the integration is disconnected later.

What it does not do

• It does not send timer sessions, comments, statuses, or approvals to monday.com.
• It does not update monday.com’s native Time Tracking column. monday.com’s API cannot update its native Time Tracking values. Optional time copying writes only the dedicated Numbers columns an administrator chooses.
• It does not import monday.com items as Keito tasks.
• It does not synchronise project budgets, rates, invoices, or people.
• It does not support classic-board subitems.
• It does not make inaccessible or private boards visible to a Keito member.

Keito remains the source of truth for time, approvals, budgets, reports, billing, and invoices. A saved item is labelled Linked. That means Keito has retained a verified reference. The label does not confirm a time-copy check; use the separate Time copying settings to see its status.

Before you connect

Confirm all of the following:

• The Keito workspace is on the Business plan.
• A Keito owner or administrator is available to make the first connection.
• The monday.com login belongs to the account the workspace intends to use.
• That login can see the boards the administrator needs to map.
• The matching Keito projects are active and the target tasks are active and assigned to those projects.
• Every team member who will link items can sign in to monday.com with their own account.

Choose the monday.com account carefully. Each Keito workspace connects to one monday.com account. Keito rejects a later connection from a different monday.com account instead of silently changing the binding.

Keito does not use monday.com’s native Time Tracking column and does not require it to be enabled. Installation still follows your monday.com account’s app-installation policies; ask a monday.com administrator to install Keito if your own login cannot install apps.

Connect the workspace

The first connection establishes which monday.com account belongs to the Keito workspace.

1. In Keito, open Settings > Integrations > monday.com.
2. Under Account access, select Link monday.com.
3. Sign in to the intended monday.com account. Install Keito if prompted, then approve its read-only access.
4. Return to Keito and confirm the connected monday.com account shown on the settings page.
5. If the account is wrong, disconnect it and contact Keito before creating mappings. Reconnection is restricted to the originally linked account.

The first company connection must be completed by a Keito owner or administrator. Other members cannot establish or replace the workspace binding.

Keito is published and shared with all monday.com accounts through a direct installation link. It is currently unlisted in the monday.com Marketplace. If installation is needed separately, a monday.com administrator can use the official Keito installation link, then return to Keito and start Link monday.com again. Installing the app alone does not connect a Keito workspace or authorize each member.

Keito requests these read-only monday.com OAuth permissions:

• me:read
• boards:read
• workspaces:read
• users:read

These permissions let Keito identify the connected account and user, find boards and supported items the user can access, and verify a selected item. They do not grant Keito permission to write to monday.com. Authorize time copying separately requests boards:write for the administrator who configures copying; it does not widen every member’s grant.

Connect each member

After the company connection is active, each member connects their own monday.com identity.

1. Open Settings > Integrations > monday.com.
2. Under Account access, select Link my account.
3. Sign in as yourself and approve the same read-only permissions.
4. Return to Keito and confirm your monday.com name is shown.

Do not share an administrator’s monday.com login. Personal connections are deliberate: search results must follow the permissions of the person recording the time. A member who cannot open a private board in monday.com cannot discover its items through Keito.

Map a board to a Keito project and task

A board mapping supplies the default Keito project and task for every supported item on that board.

1. Open Settings > Integrations > monday.com as an owner or administrator.
2. Under Board and item mappings, set Mapping level to Whole board.
3. Find a board visible to your personal monday.com connection.
4. Choose the matching active Keito project.
5. Choose an active Keito task assigned to that project.
6. Select Save mapping.

Members can select items from that board only while the mapping and its Keito target remain active and valid. Mapping a board does not give anyone access to it; each member still needs permission in monday.com.

Override one item

Use an exact item mapping when one supported item belongs against a different Keito project or task from the rest of its board.

1. Under Board and item mappings, set Mapping level to One item.
2. Select its monday.com board and enter its Item ID. You can find the item ID in its monday.com URL, after /pulses/. Keito verifies the item using your own monday.com access.
3. Choose the desired active Keito project and assigned active task.
4. Select Save mapping.

The exact item mapping takes precedence over the board mapping. Removing or changing the exact mapping affects future selections; it does not rewrite historical time entries.

Link an item while recording time

Members link monday.com work from the normal Keito time-entry form.

1. Start a new time entry or open an editable entry.
2. In monday.com item, search by item name or enter its exact item ID.
3. Choose a result. Keito automatically selects the project and task from the winning item or board mapping.
4. Add notes and a duration, or start the timer as usual.
5. Save the entry.

Search reads mapped work directly with your personal monday.com access. Classic boards and Project-format multi-level boards are supported, including nested items that share the same multi-level board. Classic-board subitems use a separate hidden board and remain unsupported. Results show the board, item ID, and parent context for nested items. If a search reaches its request or result limit, the picker reports incomplete results: narrow the name or enter the exact item ID. Keito checks the selected item and mapping again at save time, so a result cannot be used after access is removed or a mapping becomes invalid.

Recording time for another person

When an authorised manager or administrator records or changes managed time for somebody else, both people must have personal monday.com access:

• The acting user needs access so Keito can validate the action they are taking.
• The time-entry owner needs access because the saved reference belongs to their entry.

If either personal connection is missing or cannot access the item, remove the monday.com selection or have both people connect before saving a new link.

Edit, replace, or clear a link

• Edit unrelated details: changing notes, duration, date, or another compatible field preserves the existing monday.com link without re-fetching the item. If time copying is enabled, its next check reconciles eligible recorded-hour changes.
• Replace the link: search for and select another valid item. Keito verifies the new selection and applies its current mapping.
• Clear the link: clear the monday.com item field before saving.
• Change project or task: clear or reselect the monday.com item first. Keito prevents a saved reference from being paired with a project or task that conflicts with its verified mapping.

The same restrictions apply across supported Keito interfaces. An API request cannot forge a monday.com snapshot or bypass the verified project and task relationship.

Saved and historical links

The time entry stores a snapshot of the item’s name, board, and safe monday.com URL at the moment it is linked. The saved entry continues to show that information when:

• the member disconnects their personal access;
• an administrator disconnects the company connection;
• the item or board is renamed or moved;
• the item later becomes unavailable to the member; or
• a mapping is changed or removed.

Historical links are not live synchronisation. Keito does not continuously refresh saved names, and it never changes time because monday.com changes.

Copy recorded time to monday.com

Use time copying when your team wants a visible Keito-hours total on each mapped monday.com item. It is optional and off until an owner or administrator enables it.

1. Open Settings > Integrations > monday.com > Time copying as an owner or administrator.
2. Select Authorize time copying and approve the additional write permission in monday.com.
3. Choose a mapped board and a dedicated editable Numbers column, such as Keito hours. Calculated rollup columns and native Time Tracking columns cannot be selected.
4. Confirm I will use this column only for Keito hours and allow Keito to replace its values., then select Save time-copy mapping.
5. Turn on Copy tracked time to monday.com. Repeat the column mapping for each board you want to include.

Keito replaces the chosen column’s value with the item’s absolute completed recorded-hour total rather than adding hours to an existing value. Use a separate column: manually entered values in the chosen column will be replaced. The total uses actual recorded hours, not rounded billing hours, estimates, or budgets. Native Time Tracking sessions, other columns, comments, statuses, approvals, and invoices are untouched.

Each account, board and column combination belongs to one Keito workspace, including while paused or disconnected. If multiple Keito workspaces share a monday.com board, choose a different Numbers column for each workspace so their totals cannot overwrite one another.

Only entries created after the board’s first activation are eligible. Saving a column while copying is off does not start that period; turning copying on does. Running timers and earlier historical entries are excluded. Once an eligible timer is stopped, its completed hours can be copied. Edits, deletions, cleared links, and changed item links reconcile the total, including the old linked item’s total.

Keito checks about every five minutes; larger boards may need several checks. Check time copying now performs a manual check. The settings show the saved column, last check, and any problem requiring attention. A Linked reference on an entry does not prove copying succeeded.

Pause, resume, or change time copying

• Turn off Copy tracked time to monday.com to stop all copying. Existing monday.com values are preserved.
• Use Pause copying for this board to pause one board. Save that board’s column mapping again to resume it. Resuming catches up eligible entries and reconciles previously copied items after edits, deletions, or changed links.
• Changing the chosen column preserves the previous column and starts a new copying period when copying is enabled. Earlier entries are not copied into the new column.
• Reconnecting with read-only access, losing the designated administrator’s permissions, disconnecting, or leaving Business access prevents further writes. Restore the required access and check again. Keito does not use another person’s credentials as a fallback.

Disconnect monday.com

Disconnect your personal access

Under Your personal access, choose Disconnect me. Keito removes your stored monday.com credentials. You can no longer search for or newly link items until you connect again, but references already saved on time entries remain visible.

Disconnect the company connection

A Keito owner or administrator can disconnect the company connection. Keito removes the company’s and every member’s stored monday.com credentials. Board and item mapping history and references already saved on time entries are retained, but no one can make a new selection until an administrator reconnects the same monday.com account and members reconnect personally.

Keito clears its local credentials even if monday.com’s remote revocation request is temporarily unavailable. You can also review or revoke the app from monday.com’s own app management settings.

Security and access boundaries

• Sign-in uses OAuth 2.1 with PKCE; Keito never asks for or stores a monday.com password.
• Stored credentials are encrypted.
• The company connection, mappings, and time entries are scoped to one Keito workspace.
• Each member’s monday.com board permissions are enforced during search and save.
• Private-board access is never inherited from the administrator who created a mapping.
• Item URLs are validated before they are stored or displayed.
• Keito applies provider-wide rate controls and honours temporary monday.com quota limits.

Troubleshooting

monday.com says Keito must be installed

Ask a monday.com administrator to install Keito in the account you intend to connect, using the official installation link. Then return to Keito and start a fresh Link monday.com flow. If you have several monday.com accounts, check the selected account before approving access. App installation and personal OAuth authorization are separate steps.

Keito says the Business plan is required

The workspace is on Solo or Pro. A Keito owner or administrator can review the Business plan under Settings > Billing. See Plans & Pricing.

A member cannot connect

An owner or administrator must make the company connection first. After that, each member connects their own monday.com account from the same settings page.

A board or item is missing

Check that the current member can open it in monday.com and that an active board or exact item mapping exists. On the mapping screen, use Load more monday.com boards if your board is not on the first page. Search by a more specific name or enter the exact item ID when results are incomplete. Private boards follow monday.com’s member permissions. Project-format multi-level boards and their same-board nested items are supported; classic-board subitems are not.

Selecting an item reports a mapping mismatch

The mapping may have changed since the search result appeared, or the Keito project, task, or assignment may no longer be active. Ask an administrator to review the mapping, then search again. An exact item mapping overrides its board mapping.

Managed time cannot be linked

For a new or changed link on somebody else’s entry, both the acting user and the entry owner need personal monday.com connections and item access. Existing links are preserved when unrelated fields are edited.

Keito reports the wrong monday.com account

The connected account does not match the account already bound to the Keito workspace. Reconnect with a login from the original monday.com account. Keito will not silently move a workspace to a different account.

Search is temporarily rate-limited

Wait briefly and retry. Keito limits monday.com requests across the account and follows the provider’s quota response rather than continuing requests that are likely to fail.

A link still appears after disconnect

That is expected. Disconnect removes credentials and prevents new searches; it does not remove reference snapshots from historical Keito time entries.

Time copying has not updated a value

Check that copying is enabled, the board has a saved time-copy mapping, and the designated administrator still has write access. The target must be a dedicated editable Numbers column without rollup. The entry must have been created after that board’s copying period began and its timer must be stopped. Review the last check and problem shown under Time copying, then use Check time copying now. Larger boards may take several checks. Earlier history and native Time Tracking sessions are excluded.

Team setup checklist

Before inviting the whole team:

• Confirm the correct monday.com account is shown in Keito.
• Create a board mapping to an active Keito project and assigned active task.
• Add an exact item override and confirm it wins over the board mapping.
• Test with two members who have different monday.com board permissions.
• Confirm each member sees only accessible, mapped, supported items.
• Save an entry and confirm the reference is labelled Linked.
• Verify the mapped project and task are selected automatically.
• Disconnect a test member and confirm the historical reference remains visible.
• If you enable copying, choose a dedicated non-rollup Numbers column and check its status after recording new time. Native Time Tracking sessions are never updated.

Frequently asked questions

Does Keito send tracked time to monday.com?

Reference linking is read-only by default. An owner or administrator can separately enable copying of eligible completed recorded-hour totals into dedicated Numbers columns. Native Time Tracking sessions, comments, statuses, and approvals are untouched.

Does every team member need to connect monday.com?

Yes. An owner or administrator connects the company account first, then every member connects personally. This keeps monday.com’s board permissions in effect for search and save.

Can I link subitems?

You can link same-board nested items on Project-format multi-level boards. Classic-board subitems remain unsupported because they use a separate hidden board.

Which mapping wins?

An exact item mapping wins over the mapping for its board. Keito rechecks the winning mapping when the time entry is saved.

What happens to links after disconnect?

Saved item names, board names, URLs, and IDs remain visible on historical time entries. Disconnect removes credentials and stops new selections; it does not erase the references already stored in Keito.

Can a Keito workspace connect to multiple monday.com accounts?

No. Each Keito workspace binds to one monday.com account and rejects an account mismatch during reconnection. Connections and mappings remain separate for each Keito workspace.