Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

Schematic (Actions) Destination


Destination Info
  • Accepts Page, Alias, Group, Identify and Track calls.
  • Refer to it as Schematic in the Integrations object
  • This integration is partner owned. Please reach out to the partner's support for any issues.
  • This destination is in Beta

Schematic(link takes you to an external page) enables you to launch, package, meter, and monitor features with ease, so you can manage it all in one place as your business grows.

Segment is the easiest way to send events from your application to Schematic. If you already have Segment up and running in your application, Schematic recommends this approach so you don't have to implement any additional code.

Schematic maintains this destination. For any issues with the destination, contact the Schematic Support team.


Getting started

getting-started page anchor
  1. From your Segment web app, navigate to Connections > Catalog > Destinations.
  2. Search for Schematic, select the Schematic destination, and click Add destination.
  3. Select the source that will send data to Schematic, give your destination a name, then click Create destination.
  4. On the destination's Settings tab, input your Schematic API Key. To generate an API key, navigate to your Schematic workspace settings under Settings > API Keys.

Once you've connected Schematic to Segment, you can configure how you want to send data to Schematic in the Schematic destination's Mappings tab.


Property nameTypeRequiredDescription
API Keystring
required

Found on your settings page.


Schematic has the following presets

Preset NameTriggerDefault Action
Track EventEvent type = "track"Track Event
Identify UserEvent type = "identify"Identify User

Build your own Mappings. Combine supported triggers with the following Schematic-supported actions:

(information)

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Track Event

track-event page anchor

Send track events to Schematic

Track Event is a Cloud action. The default Trigger is type = "track"

Property nameTypeRequiredDescription
Event nameSTRING
required

Name of event (this will be snake cased in request)


Company keysOBJECT

Optional

Key-value pairs associated with a company (e.g. organization_id: 123456)


TimestampDATETIME
required

Time the event took place


User keysOBJECT

Optional

Key-value pairs associated with a user (e.g. email: example@example.com)


TraitsOBJECT

Optional

Additional properties to send with event

Send identify events to Schematic

Identify User is a Cloud action. The default Trigger is type = "identify"

Property nameTypeRequiredDescription
Company keysOBJECT
required

Key-value pairs associated with a company (e.g. organization_id: 123456)


Company nameSTRING

Optional

Name of company


Company traitsOBJECT

Optional

Properties associated with company


TimestampDATETIME
required

Time the event took place


User keysOBJECT
required

Key-value pairs associated with a user (e.g. email: example@example.com)


User nameSTRING

Optional

User's full name


User traitsOBJECT

Optional

Properties associated with user


Schematic only accepts Track event names that contain alphanumeric characters, dashes, and underscores. If Segment event names have other characters, like spaces, the Schematic destination automatically snake_cases the event name before passing to Schematic. Segment passes the raw event name as an event trait.


You can send computed traits and audiences generated using Engage to this destination as a user property. To learn more about Engage, schedule a demo(link takes you to an external page).

For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it's been more than 30 days since their last order), Engage sets that value to false.

When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

(information)

Real-time to batch destination sync frequency

Real-time audience syncs to Schematic (Actions) may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.


Segment lets you change these destination settings from the Segment app without having to touch any code.

Property nameTypeRequiredDescription
API Keystring
required

Found on your settings page.