GEgetsales
playtables

Create playtable

Create a table plus its two default views (object_type=company and people, name "Default view", empty columns/sort/filter) in one transaction; the returned row carries both view sids. Idempotent dedup on (team_sid, name): a duplicate returns the existing row with already_exists:true. config.auto_run defaults to false - paid fields do not fire on import until enabled. The usual next step is create_data_source targeting the new sid.

Contract:

  • MCP tool create_playtable, registry package mcp.playtables/playtables, mount playtables.tables.
  • Operation create, response envelope create.
  • Flags: none.
post/api/playtables

Request

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

Request body

namestring required

Table name; unique per team - the dedup natural key.

descriptionstring nullable

Free text about the table (max 2000), shown on it.

agent_sidstring nullable

The AI SDR for this table (ub_ag_…, from search_agents on unibox); left out or null = the team's default agent. The prefix is all playtables checks.

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.