--- title: Roserocket API Integration on Truto slug: roserocket category: Default canonical: "https://truto.one/integrations/detail/roserocket/" --- # Roserocket API Integration on Truto **Category:** Default **Status:** Generally available ## MCP-ready AI tools Truto exposes 19 tools for Roserocket that AI agents can call directly. - **list_all_roserocket_boards** — List board navigation items in Rose Rocket for a given object type. Returns: id, objectKey, name, fullId, widgets, widgetToOpen, and locations per board item. Optionally filter by object_key (e.g. customer, order) and control sort order with order_by_direction. - **list_all_roserocket_events** — List events for a given record in roserocket. Returns: id, objectKey. Required: record_id, object_key. - **create_a_roserocket_event** — Create an event for a record in roserocket. Returns: id, objectKey. Required: recordId, boardId, type, json. - **list_all_roserocket_objects** — Search and list Rose Rocket platform model object records. Returns: id, objectKey. Additional fields depend on the objectKey type. Filter by objectKey in the request body to scope results to a specific record type. - **get_single_roserocket_object_by_id** — Get a single Rose Rocket platform model object record by id. Returns: id, objectKey. Additional fields depend on the objectKey type. Required: id. - **create_a_roserocket_object** — Create a new Rose Rocket platform model object record. Returns the created record including id and objectKey. Additional fields depend on the objectKey type. - **update_a_roserocket_object_by_id** — Update or upsert a Rose Rocket platform model object record by id. Returns: id, objectKey. Additional fields depend on the objectKey type. Required: id, objectKey. - **roserocket_objects_partial_update** — Partially update a Rose Rocket platform model object record. Returns: id, objectKey. Additional fields depend on the objectKey type. - **delete_a_roserocket_object_by_id** — Delete a Rose Rocket platform model object record by id. Returns the deleted record: id, objectKey. Required: id. - **roserocket_objects_bulk_delete** — Bulk delete multiple Rose Rocket platform model object records by their ids. Returns an empty 204 response on success. - **get_single_roserocket_objects_external_by_id** — Get a roserocket platform model object by its external ID. Returns: id, objectKey, externalId, orgId, source, createdAt, updatedAt, and version. Required: object_key, id. - **update_a_roserocket_objects_external_by_id** — Upsert a roserocket platform model object by its external ID, updating the record if it exists or creating it if not. Returns: id, objectKey, externalId, orgId, source, createdAt, updatedAt, and version. Required: object_key, id. - **delete_a_roserocket_objects_external_by_id** — Delete a roserocket platform model object by its external ID. Returns an empty 204 response on success. Required: object_key, id. - **list_all_roserocket_objects_autocomplete** — List autocomplete suggestions for roserocket platform model objects. Returns matching records with object-type-specific fields that vary by object_key (e.g. Customer, Order, Task, Address, Partner, Invoice). All query parameters are optional: narrow results by object_key, search_term, ids, or set label_path to control which field is used as the display label. - **list_all_roserocket_user_groups** — List all roserocket user groups belonging to the org. Returns: id, name, type, description. - **create_a_roserocket_user_group** — Create a new roserocket user group and return the result. Returns: id, name, type, description. Required: name. - **roserocket_user_groups_search** — Search roserocket user groups by name or IDs. Returns: id, name, type, description. Max 200 results per page. - **list_all_roserocket_user_group_members** — List members of a roserocket user group. Returns: id, addedAt, addedBy for each member. Required: group_id. - **update_a_roserocket_user_group_member_by_id** — Add or remove members in a roserocket user group. Returns: added (count of users added), removed (count of users removed). Required: group_id. If a user ID appears in both add and remove, removal takes precedence. ## How it works 1. **Link your customer's Roserocket account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Roserocket.** The Proxy API is a 1-to-1 mapping of the Roserocket API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync CRM deals into Rose Rocket as freight orders** — Logistics CRMs and quoting tools can automatically push closed-won deals into Rose Rocket as Customer, Address, and Order objects, eliminating manual rekeying between sales and dispatch teams. - **Stream telematics and visibility data onto Rose Rocket boards** — GPS, ELD, and supply chain visibility platforms can inject location pings, milestone updates, and task completions directly onto Order timelines so dispatchers see real-time status without leaving the TMS. - **Automate invoice factoring and freight finance workflows** — Factoring and AR platforms can poll Rose Rocket for completed Invoice objects, advance funds to carriers, and write back audit events confirming payment status on the Order record. - **Provision dispatch teams from identity and HR systems** — SCIM-style identity and HRIS tools can keep Rose Rocket user groups in sync, automatically adding dispatchers, drivers, or account managers to the right cohorts as employees join or change roles. - **Log automated actions to Rose Rocket order timelines** — Any SaaS performing automated validation, communication, or compliance checks can write timeline events to Rose Rocket records, giving operations teams a single audit trail per load. ## What you can build - **Upsert by external ID** — Use your own database primary keys to create or update Rose Rocket Customers, Addresses, Orders, and other objects without maintaining a separate ID mapping table. - **Dynamic object sync across any Rose Rocket entity** — Build a single sync engine that reads and writes Customers, Orders, Tasks, Addresses, Partners, and Invoices through the generic Objects endpoints by switching the objectKey. - **Timeline event injection** — Push status updates, geolocation pings, factoring confirmations, or system notes onto any Rose Rocket record's timeline as native events. - **Bulk cleanup and lifecycle management** — Use bulk delete and partial update operations to efficiently archive stale orders, correct misrouted records, or backfill changes after a migration. - **User group and access provisioning** — Create user groups, search existing ones, and update group memberships to keep dispatch teams and driver cohorts aligned with your customer's identity source. - **Board-aware autocomplete experiences** — Power in-app pickers and search-as-you-type fields with the autocomplete endpoint so your users can reference Rose Rocket records natively inside your product. ## FAQs ### How does authentication to Rose Rocket work through Truto? Truto manages the credential exchange and token storage for Rose Rocket on behalf of your end users. Your product never sees raw API keys — you call Truto's endpoints and we attach the right credentials per connected account. ### Which Rose Rocket entities can we read and write? Rose Rocket exposes a generic Objects API addressable by objectKey (e.g., Customer, Order, Task, Address, Partner, Invoice), plus dedicated endpoints for Boards, Events, User Groups, and User Group Members. Truto wraps list, get, create, update, partial update, delete, and bulk delete operations across these. ### Can we upsert records using our own IDs instead of Rose Rocket's? Yes. Rose Rocket supports external ID lookup, update, and delete operations, so you can pass your own primary keys (e.g., a Salesforce or internal record ID) to manage Rose Rocket objects idempotently without storing a separate ID map. ### How do we get real-time updates from Rose Rocket? The current Rose Rocket toolset is request/response. To keep data fresh, you can poll list endpoints (filtered by objectKey) on a schedule via Truto, and write outbound updates as Events. If webhook support is needed for a specific use case, reach out and we can scope it. ### Can we write to a record's activity timeline? Yes. The Events API lets you create timeline entries on Rose Rocket records — useful for logging automated actions, status changes, integration health signals, or third-party confirmations like factoring approvals. ### Does the integration support custom fields and composable boards? Rose Rocket's data model is composable via Boards and dynamic Objects. Because reads and writes are routed by objectKey, custom object types and fields defined in your customer's Rose Rocket workspace are accessible through the same generic endpoints.