---
title: Sendoso API Integration on Truto
slug: sendoso
category: Marketing Automation
canonical: "https://truto.one/integrations/detail/sendoso/"
---

# Sendoso API Integration on Truto



**Category:** Marketing Automation  
**Status:** Beta

## Unified APIs

### Unified User Directory API

- **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams.
- **Roles** — The Role object represents a role of a User.
- **Users** — The User object represents a User.

## MCP-ready AI tools

Truto exposes 12 tools for Sendoso that AI agents can call directly.

- **list_all_sendoso_users** — List all active users in Sendoso organization. Returns current_page, per_page, total_users, and users array with id, first_name, last_name, email, and team_group_id.
- **create_a_sendoso_user** — Create a new user invitation in Sendoso for a specific team group using team_group_id. Returns success status, message, receiver_email, team_group_id, user_role, invitation_status, and expires_at.
- **list_all_sendoso_me** — Get current user details in Sendoso. Returns id, first_name, last_name, email, role, balance, and team_balance in the response.
- **list_all_sendoso_groups** — List all active team groups in Sendoso. Returns group details including id, name, budget, team_id, and timestamps. Supports pagination through page and per_page query parameters.
- **list_all_sendoso_team_group_users** — Get all users for a specific team group in Sendoso. Requires team_group_id. Returns id, first_name, last_name, email, balance, sandbox, team_group_id, team_id, and key for each user.
- **list_all_sendoso_campaigns** — Get all active campaigns in Sendoso. Returns id, name, start_date, end_date, description, created_at, user_id, gift_id, status, delivery_type, currency, and ship_to_countries fields in the response.
- **get_single_sendoso_campaign_by_id** — Get details about a specific campaign in Sendoso using id. Returns fields including id, name, start_date, description, status, delivery_type, and currency, which provide key information about the campaign configuration and activity.
- **list_all_sendoso_sends** — List all sends in Sendoso. Returns id, send_gid, type, subtype, currency, current_total_cost, status, created_at, touch, recipient, sender, sent_via, and status_updates for each send.
- **create_a_sendoso_physical_gift** — Send a physical gift in Sendoso using recipient information such as name, email, and address. Returns success, message, and tracking_code in the response.
- **create_a_sendoso_physical_gift_address_collection** — Create a new physical gift send request with address collection in Sendoso. Requires touch_id, name, email, no_address, confirm_address, address_confirmation_via, resume_with_unconfirmed_address, expire_after_days, hide_product_info, via, and via_from. Returns success status, message, and tracking_code in the response.
- **create_a_sendoso_egift** — Send an eGift via Sendoso Email. Requires touch_id, email, via, and via_from. Returns success status, message, tracking_code, and tracking_url to confirm and track the eGift delivery.
- **create_a_sendoso_egift_link** — Generate one or more eGift links in Sendoso for recipients using touch_id, via, via_from, and recipient_users. Returns egift_link and recipient_email_or_phone_number for each recipient.

## How it works

1. **Link your customer's Sendoso 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 Sendoso.** The Proxy API is a 1-to-1 mapping of the Sendoso 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

- **Embed gifting steps into automated sales sequences** — Sales engagement platforms can offer Sendoso as a native action node within cadences, letting reps trigger physical gifts or eGifts at specific sequence steps without leaving the platform. Truto handles auth and API normalization so your team ships the integration faster.
- **Incentivize survey completion with instant eGift rewards** — Customer feedback and survey platforms can automatically deliver eGift links on completion screens by calling Sendoso's eGift link endpoint, turning gifting into a zero-friction incentive that drives higher response rates without manual fulfillment.
- **Automate employee lifecycle gifting from HR platforms** — HRIS and People Ops tools can trigger welcome kits, anniversary swag, and milestone gifts when employee statuses change, using Sendoso's address collection flow to securely gather shipping details from new hires before dispatching physical items.
- **Drive post-event engagement with automated gift delivery** — Event and webinar platforms can reward attendees with eGifts the moment they join a session, tying Sendoso fulfillment to real-time attendance data to boost engagement and create memorable post-event touchpoints.
- **Govern team gifting budgets from within your platform** — B2B platforms managing multi-team workflows can map their own user groups and permissions to Sendoso's team and budget structures, ensuring reps only send gifts within their allotted limits and admins retain spend visibility.

## What you can build

- **Send Gift action node in workflow builders** — Let users select a Sendoso campaign from a dynamically populated dropdown (via list_all_sendoso_campaigns) and configure automated physical gift, eGift, or address collection sends as a step in any workflow.
- **Embeddable eGift link delivery** — Generate raw eGift URLs via create_a_sendoso_egift_link and render them directly inside your product's UI, confirmation pages, or templated emails — no separate Sendoso email required.
- **Address collection flow for B2B contacts** — Trigger Sendoso's secure address collection email (create_a_sendoso_physical_gift_address_collection) when your platform only has a contact's email, removing the need for users to manually gather shipping details.
- **Gift delivery status tracker and follow-up triggers** — Poll list_all_sendoso_sends to surface delivery statuses inside your app, and auto-trigger downstream actions like follow-up tasks or notifications when a package is marked delivered.
- **Team and budget sync via Unified User Directory** — Use Truto's Unified User Directory API to read Sendoso groups, roles, and users alongside your platform's own org structure, enabling consistent permission mapping and budget governance across systems.
- **Automated user provisioning into Sendoso teams** — When a new rep is added in your platform, auto-create their Sendoso account and assign them to the correct team group via create_a_sendoso_user, eliminating manual onboarding steps.

## FAQs

### What authentication method does the Sendoso integration use through Truto?

Truto manages the full OAuth or API key-based auth flow on behalf of your end users. Your application never stores or rotates Sendoso credentials directly — Truto handles token management and refresh.

### Can I read Sendoso users, groups, and roles through a unified schema?

Yes. Sendoso is mapped to Truto's Unified User Directory API, which provides normalized Users, Groups, and Roles resources. You can list users (list_all_sendoso_users), groups (list_all_sendoso_groups), and team group members (list_all_sendoso_team_group_users) through a consistent schema.

### What types of sends can I create programmatically?

Four send types are supported: physical gifts with a known address (create_a_sendoso_physical_gift), physical gifts with address collection via email (create_a_sendoso_physical_gift_address_collection), eGifts delivered by email (create_a_sendoso_egift), and standalone eGift links you can embed in your own UI (create_a_sendoso_egift_link).

### How do I let users pick which gift to send?

Use list_all_sendoso_campaigns to fetch all active campaigns (each representing a specific gift, swag item, or eGift). You can render these in a dropdown or selection UI. Use get_single_sendoso_campaign_by_id to pull details like currency and delivery type for a specific campaign.

### Can I track delivery status and gift costs?

Yes. The list_all_sendoso_sends endpoint returns send records including status updates and cost data. You can poll this endpoint to sync delivery statuses into your app for ROI tracking or to trigger follow-up workflows when a gift is delivered.

### Does Truto handle pagination for Sendoso list endpoints?

Yes. Truto abstracts away Sendoso's pagination logic. When you call any list endpoint (sends, campaigns, users, groups), Truto manages cursor or page-based pagination transparently, so you receive complete result sets without implementing pagination yourself.