GEgetsales
sender_profiles

Create sender profile

Create a sender profile: the person the team sends as. It has no sending window and no timezone: a schedule is a workflow's, counters count in the workspace's day. No channel is needed at birth: bind LinkedIn afterwards (attach_sender_profile_linkedin, start_sender_profile_linkedin_connect) and mailboxes with the mailbox verbs. Account refs may ride the create: a live sender profile already holding one comes back already_exists true; refs at two sender profiles are 409.

Contract:

  • MCP tool create_sender_profile, registry package mcp.unibox/sender_profiles, mount unibox.sender-profiles.
  • Operation create, response envelope create.
  • Flags: none.
post/api/sender-profiles

Request

  • Base URL
    https://beta.getsales.io/unibox/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Request body

namestring required

Display persona name. The sender profile keeps it for life: attaching an account never overwrites it.

labelstring nullable

The free text under the name in the list ("Outbound EU"). An empty string is stored as null.

linkedin_account_sidstring nullable

Optional: bind a gtm-api LinkedIn account the tenant already holds at birth (ln_ac_…, not existence-checked here). Otherwise use the channel verbs afterwards.

email_account_sidstring nullable

Optional: bind a gtm mailbox at birth (em_ac_…). It becomes the primary mailbox.

linkedin_history_sincestring nullable

The history window of the LinkedIn account bound at birth: import its conversations from this day (YYYY-MM-DD) on, or none of the past with now (from the create on); omitted or null = all of them. Stored only when linkedin_account_sid rides the create.

email_history_sincestring nullable

The history window of the mailbox bound at birth, as for linkedin_history_since. Stored only when email_account_sid rides the create.

linkedin_history_scope'all' | 'playtable_people' nullable

The import scope of the LinkedIn account bound at birth: playtable_people (omitted or null, the default) takes only conversations with a person the workspace keeps in a playtable, all every conversation. Stored only with linkedin_account_sid.

email_history_scope'all' | 'playtable_people' nullable

The import scope of the mailbox bound at birth, as for linkedin_history_scope. Stored only when email_account_sid rides the create.

avatar_urlstring nullable

Display photo URL; a LinkedIn account bound to the sender profile replaces it with the account's own photo.

assignee_user_sidstring nullable

Operator of the sender profile (external user sid, not existence-checked): the default assignee for the tasks its threads spawn.

Response

create success envelope.

successtrue required
operation'create' required
already_existsboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.