Overview
The RB2B OEM program allows partners to seamlessly integrate RB2B’s identification technology into their own platforms. Through a simple API and real-time webhook system, OEM partners can manage domains and receive live data directly into their systems.
ℹ️ Important: Domains must be explicitly added and authorized via the API before RB2B can track or report any data for them.
The API is the only supported method for adding, removing, or listing domains associated with your OEM account. Domains not added via the API will be ignored by the system—even if the tracking script is installed.
Accessing Your OEM API Key
Once you’re enrolled in the OEM program, your unique API key is available in your dashboard:
Where to find it
Go to your Dashboard at https://app.rb2b.com/oem_dashboard
Locate the API Key card
Use the Copy button to copy the key in plain text
Key management
We recommend contacting RB2B support regarding your key if:
You suspect it has been exposed or compromised
A team member with access to it leaves your organization
ℹ️ Important: After regenerating, you’ll need to update any systems that use the previous key.
Domain Management APIs
RB2B provides three simple endpoints to manage which domains are tracked under your OEM account.
Headers
Key | Value |
Api-Key | {{api_key}} |
Content-Type | application/json |
Accept | application/json |
User-Agent | required |
Add a Domain
Domains should be formatted in full (e.g., sub.domain.com) and must be added before RB2B can process or report on their traffic.
Method: POST
Endpoint: https://app.rb2b.com/api/v1/add_domain
Request Body:
{
"domain": "sub.domain.com"
}Response:
{
"domain": "sub.domain.com",
"added": true
}
Remove a Domain
Method: POST
Request Body:
{
"domain": "sub.domain.com"
}Response (success):
{
"domain_deleted": true
}Response (error):
{
"error": "domain does not exist for account"
}List All Active Domains
Method: GET
Endpoint: https://app.rb2b.com/api/v1/domains
Request Body: none
Response (success):
{
domains: {
"retention.com",
"rb2b.com"
}
}
Credit Usage API
RB2B provides a simple endpoint to monitor your credit usage on your OEM account.
Method: GET
Endpoint: https://app.rb2b.com/api/v1/credit_usage
Request Body: none
Response (success):
{
"credits_used": 3833,
"last_billing_date": "2026-02-09T19:00:13Z",
"next_billing_date": "2026-03-09T19:00:13Z"
}
Configuring Your Webhook URL
Your webhook allows you to receive real-time data from RB2B as visitor de-anonymization and pageviews occur.
To set up your webhook
Go to your Dashboard at https://app.rb2b.com/oem_dashboard
Navigate to Webhook Configuration
Add your Webhook URL
Once set, RB2B will begin sending every page view from your added domains to this URL in real time.
Sample Webhook Payload
{
"LinkedIn URL": "https://www.linkedin.com/in/retentionadam/",
"First Name": "Adam",
"Last Name": "Robinson",
"Title": "CEO @ Retention.com. We help Ecomm brands grow & monetize their first-party audience",
"Company Name": "Retention.com",
"Business Email": "[email protected]",
"Website": "https://retention.com",
"Industry": "Internet Technology & Services",
"Employee Count": "1-10",
"Estimate Revenue": "$22M rev",
"City": "Austin",
"State": "Texas",
"Zipcode": "73301",
"Seen At": "2024-01-01T12:34:56:00.00+00.00",
"Referrer": "https://retention.com",
"Captured URL": "https://rb2b.com/pricing"
}Optional Additional Information
{
"customer_id": "12345"
}For information on how to configure the customer_id value, please see the documentation on Installing Your RB2B OEM Tracking Script.
Content Format
The data from RB2B will be transmitted in the following formats for each field:
LinkedIn URL: string* (URL)
First Name: string, null
Last Name: string, null
Title: string, null
Company Name: string, null
Business Email: string, null
Website: string (URL), null
Industry: string, null
Employee Count: integer, string, null
Estimate Revenue: string, null
City: string*
State: string*
Zipcode: string*
Seen At: datetime* (ISO 8601 format)
Referrer: string (URL), null
Captured URL: string* (URL)
Tags: string, null
Company-Level Identification
By default, RB2B's OEM script both contact-level and company-level visitors. If you wish to only identify contact-level visitors, you turn off company-level collection in your dashboard.
Where to find it
Go to your Dashboard at https://app.rb2b.com/oem_dashboard
Locate the Company-Level Identification card
Toggle the setting to Yes or No depending on whether or not you want to track company-level visitors
Click Save
How It All Works Together
Here’s a quick summary of how the RB2B OEM integration flows:
Add domains via API to associate them with your account.
Deploy the RB2B tracking script on those domains.
Receive real-time visitor data through your configured webhook.
Remove domains via the API when they’re no longer active or needed.
This system gives you full programmatic control over which domains are tracked and ensures you receive actionable data instantly as it’s collected.