Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.targeter.tech/llms.txt

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

Get started in three steps

Connect your platform to Targeter and start creating campaigns for your clients.

Step 1: Receive your issued API credentials

As a trusted third-party partner, you will receive API credentials from Targeter: - API Key: Your unique partner identifier issued by Targeter - API Secret: Your secure authentication secret issued by Targeter These credentials are required for all API requests and are only provided to approved partners.
Targeter uses JWT (JSON Web Token) authentication for third-party partners: 1. Exchange your issued API credentials for a JWT token 2. Include the token in the Authorization header for protected routes 3. Tokens expire after 1 hour for security
Always store your issued API secret securely and never expose it in client-side code. These credentials are for server-to-server communication only.

Step 2: Make your first integration call

Start by obtaining a JWT token using your partner credentials:
curl -X POST "https://storhaug.targeter.tech/api/auth/token" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_ISSUED_PARTNER_KEY",
    "api_secret": "YOUR_ISSUED_PARTNER_SECRET"
  }'
Response:
{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6...",
    "token_type": "Bearer",
    "expires_in": 3600
}
Now create a campaign on behalf of your client using your JWT token:
curl -X POST "https://storhaug.targeter.tech/api/campaign" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "material": ["https://client-assets.com/property.jpg"],
      "name": "Client Property Campaign",
      "reference_id": "CLIENT-PROP-001",
      "target_url": "https://client-site.com/property/001"
    }
  }'
Depending on whether a campaign already exists and whether automatic creation applies, you may get 200 with campaign_link, or 201 with either ad_creation_link and campaign_id, or campaign_link only. See Campaigns.Example 201 when automatic creation succeeds:
{
    "ad_creation_link": "https://storhaug.targeter.tech/...",
    "campaign_id": "AbC123xyz"
}

Step 3: Complete your integration

Now that you’ve made your first integration call, explore our complete partner API reference:

Next steps

Ready to complete your Targeter integration? Here’s what you can do next:

Partner Authentication

Learn about JWT authentication and security best practices for partners.

Campaign API

Create and manage targeted marketing campaigns for your clients.

Partner API Reference

Explore our complete third-party integration documentation.

Partner Support

Get help from our partner integration support team.
Need integration help? Contact our partner support team at support@targeter.tech for assistance with your third-party integration or any questions.