Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.useparagon.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Connecting to Segment

Your users will need the following information to connect their Segment account with your integration built with Paragon Connect:
  • Segment API Key
This is an API-only integration - workflow actions for this integration are still in development. You can still connect user accounts, build workflows, and access the API for this integration.
Once your users have connected their Segment account, you can use the Paragon SDK to access the Segment API on behalf of connected users. See the Segment REST API documentation for their full API reference. Any Segment API endpoints can be accessed with the Paragon SDK as shown in this example. 
// You can find your project ID in the Overview tab of any Integration

// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
            
// Create a new source
paragon.request("segment", "/sources", {
  method: "POST",
  body: {
    "slug": "my-test-source-r-dsv2",
    "name": "My Source",
    "enabled": true,
    "metadataId": "IqDTy1TpoU",
    "settings": { ... }
  }
});

// List all warehouses
paragon.request("segment", "/warehouses", {
  method: "GET"
});

​
Building Segment workflows

Once your Segment account is connected, you use the Segment Request step to access any of Segment’s API endpoints without the authentication piece. When creating or updating records in Segment, you can reference data from previous steps by typing {{ to invoke the variable menu.