# Getting Started

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](https://bullseye.so/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](/partner-api/partner-api.md)
* 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

```bash
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](/partner-program/branding.md) 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

```bash
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](/partner-program/sub-organizations.md) and [Credit Management](/partner-program/credit-management.md) for more details.

## Checklist

| Step                       | Description                                        |
| -------------------------- | -------------------------------------------------- |
| Partner account created    | Your partner account is active and accessible      |
| API key generated          | At least one API key created and stored securely   |
| Branding configured        | Logo, colors, and company name set                 |
| First organization created | A sub-organization is set up for your first client |
| Tracking pixel installed   | The pixel is deployed on the client's website      |
| Webhooks configured        | Real-time notifications are set up (optional)      |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bullseye.so/partner-program/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.