Getting Started as a Partner

This guide walks you through the process of joining the Bullseye whitelabel partner program and setting up your first client organization.

Applying for the Partner Program

To become a Bullseye whitelabel partner:

1. Contact the Bullseye team at support@bullseye.so or book a demo to discuss your needs
2. Complete the partner application with details about your business, expected volume, and use case
3. Review and sign the partner agreement
4. Receive your partner account with access to the Partner Dashboard and API

Onboarding Process

Once your partner account is created, you will receive:

• Access to the Partner Dashboard for managing organizations, branding, and billing
• Your first API key for programmatic access via the Partner API
• A dedicated onboarding session to walk through the platform capabilities
• Documentation and resources to help you integrate Bullseye into your product

Obtaining API Keys

API keys are used to authenticate requests to the Partner API. You can manage them from the Partner Dashboard or via the API.

From the Partner Dashboard

1. Navigate to API Keys in the Partner Dashboard
2. Click Create API Key
3. Enter a descriptive name for the key
4. Select the appropriate scopes (read, write, or admin)
5. Copy the key immediately — it will only be displayed once

Via the Partner API

curl -X POST https://api.app.bullseye.so/api/v1/partner/api-keys 
  -H "X-Partner-API-Key: YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"name": "Production Key", "scopes": ["read", "write"]}'

Important: The raw API key value (plainKey) is only returned once in the creation response. Store it securely, as it cannot be retrieved again.

Setting Up Branding

Customize the platform appearance for your clients by configuring your brand identity:

1. Logo — Upload your company logo (URL to hosted image)
2. Primary color — Set your primary brand color as a hex value (e.g., #1A73E8)
3. Secondary color — Set your secondary brand color as a hex value
4. Company name — Set the company name that appears throughout the platform

See Custom Branding for full details.

Creating Your First Sub-Organization

Once your partner account is configured, create a sub-organization for your first client:

Via the Partner API

curl -X POST https://api.app.bullseye.so/api/v1/partner/organizations 
  -H "X-Partner-API-Key: YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "name": "Acme Corp",
    "externalId": "acme-123",
    "tier": "trial",
    "initialCredits": 200
  }'

The response includes the organization details along with the pixelApiKey and scriptTag needed to install the tracking pixel on your client’s website.

Next Steps

After creating your first organization:

1. Install the tracking pixel on your client’s website using the provided script tag
2. Configure ICP filters to score and filter visitors for your client
3. Set up webhooks to receive real-time identification notifications
4. Allocate credits from your credit pool to the organization

See Sub-Organizations and Credit Management for more details.

Checklist