Skip to main content
POST
Map a source entity to a property

Authorizations

Authorization
string
header
required

Authorization: Bearer <token>. Token types resolve to the same scoped credential: a user-generated API key (casa_…, from Account settings — recommended for machines and MCP clients), a WorkOS AuthKit session JWT (the web app; org and role come from verified token claims), or a static token. API keys are group-scoped, optionally pinned to one property at creation. MCP OAuth connector tokens authenticate the MCP server only and are rejected on these REST routes.

Path Parameters

id
string<uuid>
required

Resource id (UUID).

Body

application/json
source_ref
string
required

Source entity id to map.

property_id
string<uuid>

Target property (must be in the caller's group). Ignored when the credential is pinned to a property.

Response

Created.

data
object
required

A source entity mapped to a property under a connection, joined with its connection for display. id is the integration_id every canonical row references.