Skip to main content

​
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 plain-text authentication secret issued by Targeter
  • Base URL: The API host for your integration (e.g. https://app.targeter.tech/api)
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
Send the plain-text secret in api_secret — not a bcrypt hash. 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://app.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://app.targeter.tech/api/campaign" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "material": [
        "https://example.com/property-photo.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, you get 200 or 201 with a campaign_link. New campaigns also include campaign_id. Use GET /campaign to fetch the campaign, stats, and app link. See Create campaign.Example 201 when automatic creation succeeds:
{
    "campaign_link": "https://app.targeter.tech/campaigns/AbC123xyz",
    "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.

Create campaign

Create and resolve targeted marketing campaigns for your clients.

Get campaign

Fetch campaign details, stats, and app links.

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.