Ripe Docs
  • Welcome to Ripe Docs
  • Getting Started
    • Connect your product data
    • Connecting your CRM
  • Connect Product Data
    • Connect with Segment
    • Connect with Tag Manager
    • Connect with Ripe SDK
      • Install the Ripe SDK Script
      • Ripe.identify
      • Ripe.track
      • Ripe.page
      • All Ripe SDK Calls
    • Connect with Ripe API
  • Sync CRM
    • Connect Salesforce
      • Key Concepts Overview
      • Timeline data
      • Automatic entity creation
    • Connect HubSpot
      • Key concepts Overview
      • Sync Modes
      • Automatic entity creation
      • Workflows & Automation
      • Timeline data
  • Widget customization
    • Page targeting
    • Widget visibility
    • Widget position & offset
    • Personalization Variables
  • Ripe Concepts
    • Leads
    • Companies
    • Workflows
    • Videos
      • Profile videos
      • Sending videos
    • Sessions
  • How-to
    • Whitelist Ripe in your CSP
    • Identity resolution
Powered by GitBook
On this page
  • Authentication
  • Identify
  • Identify a user
  • Track
  • Track a user action
  • Page
  • Track a page visit
  • Group
  • Identify a workspace/group
  1. Connect Product Data

Connect with Ripe API

How to send your events via the Ripe API

The API is ideal for sending updates to your entity's traits and other key info needed to properly segment your user base.

Authentication

All requests are authenticated using your API key. The API should be base64 encoded and sent in the Authorization header of your request, like this:

Authorization: Basic <base64 encoded key>

Identify

You should call Ripe.identify when you set a unique identifier for a lead/user, preferably an UID from your database. You should also call Ripe.identify every time a user either logs in or updates any of the attached traits e.g. email etc.

Identify a user

POST https://api.getripe.com/event/identify

Headers

Name
Type
Description

Authorization

String

Base64 encoded API key

Request Body

Name
Type
Description

anonymousId

String

Not required if userId is set

userId

String

Not required if anonymousId is set

messageId*

String

Unique message identifier

timestamp*

String

The event timestamp as a ISO-8601 date time string

traits

Object

Key-value pairs of user traits

context

Object

Key-value pair of contextual information. Only groupId is supported currently

Track

Use track calls to record what actions your lead/user performs in your products and on your websites. You can also attach properties contextual to the action taken.

Track events should be flattened whenever possible. For example, rather than Clicked button with Book a Demo as a property, use "Clicked Book a Demo Button".

Track a user action

POST https://api.getripe.com/event/track

Headers

Name
Type
Description

Authorization

String

Base64 encoded API key

Request Body

Name
Type
Description

anonymousId

String

Not required if userId is set

userId

String

Not required if anonymousId is set

messageId*

String

Unique message identifier

timestamp*

String

The event timestamp as a ISO-8601 date time string

event*

String

The event name

properties

Object

Key-value pairs of event properties

context

Object

Key-value pair of contextual information. Only groupId is supported currently

Page

Use page calls to track what pages your users visit. This is should be called on each page load in a traditional web page and on route changes in SPA applications.

Track a page visit

POST https://api.getripe.com/event/page

Headers

Name
Type
Description

Authorization

String

Base64 encoded API key

Request Body

Name
Type
Description

anonymousId

String

Not required if userId is set

userId

String

Not required if anonymousId is set

messageId*

String

Unique message identifier

timestamp*

String

The event timestamp as a ISO-8601 date time string

name

String

The page name

properties

Object

Key-value pairs of page properties

context

Object

Key-value pair of contextual information. Supports groupId and a nested 'page' object with the following properties: path, referrer, search, title and url

Group

This method is used to identify a workspace or account that a lead/user belongs to. The group_id is preferably an id from your database.

Identify a workspace/group

POST https://api.getripe.com/event/group

Headers

Name
Type
Description

Authorization

String

Base64 encoded API key

Request Body

Name
Type
Description

anonymousId

String

Not required if userId is set

userId

String

Not required if anonymousId is set

messageId*

String

Unique message identifier

timestamp*

String

The event timestamp as a ISO-8601 date time string

groupId*

String

The unique group identifier

traits

Object

Key-value pairs of group traits

PreviousAll Ripe SDK CallsNextConnect Salesforce

Last updated 11 months ago