789 Soft API Documentation

Programmatically manage your email marketing campaigns, automate creation, and retrieve detailed analytics reports.

Base URL: https://api.789soft.com/v1

Authentication

Authenticate your requests by including your API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY_HERE

Create Campaign

Create and launch a new email marketing campaign. This endpoint will deduct credits from your account immediately.

POST /campaign/create

Request Body (JSON)

Field Type Description
campaign_name string Required. Internal name for your campaign (also used as Brand Name).
website_url string Required. The product or landing page URL (for AI context).
affiliate_url string Required. The tracking link to be inserted in emails.
countries array Required. List of target country codes (ISO 2-letter).
Example: ["US", "DE", "FR"]
category string Required. Niche category. Options: finance, ecommerce, saas, dating, crypto.
email_style string Required. Options: professional, casual, urgent, storytelling.

Example Request

{
    "campaign_name": "Winter Sale Promo",
    "website_url": "https://myshop.com",
    "affiliate_url": "https://myshop.com?ref=123",
    "countries": ["US", "CA"],
    "category": "ecommerce",
    "email_style": "urgent"
}

Success Response

{
    "status": 200,
    "msg": "Campaign created successfully",
    "data": {
        "id": 145,
        "credits_deducted": 200,
        "credits_remaining": 850,
        "status": "pending"
    }
}

Get Campaign Report

Retrieve detailed performance metrics for a specific campaign, including click-through granular data by country.

GET /reports/{campaign_id}

Example Response

{
    "status": 200,
    "data": {
        "id": 145,
        "status": "completed",
        "metrics": {
            "sent": 16372,
            "opens": 8500,
            "clicks": 4565,
            "average_ctr": 27.88
        },
        "clicks_by_country": {
            "US": {
                "clicks": 2100,
                "ctr": 22.5,
                "cpc": 0.05
            },
            "DE": {
                "clicks": 1014,
                "ctr": 40.29,
                "cpc": 0.05
            }
        }
    }
}

Conversion Tracking & Postback

Send conversion data back to 789 Soft to improve list quality and earn bonus credits. When you report conversions, we reward you while optimizing future campaigns for better performance.

💰 Rewards Program - Category-Based Cashback:

Earn credit cashback for every confirmed conversion you report. Rates vary by category:

Category Cashback Rate
SaaS (Software as a Service) 0.10%
Finance & Investment 0.09%
eCommerce 0.07%
Dating & Lifestyle 0.06%
Crypto & Trading 0.05%

Example: 100 credit SaaS campaign with 200 conversions = 0.1 bonus credits

POST /conversions/track

Request Body (JSON)

Field Type Description
campaign_id integer Required. The campaign ID from your original creation response.
click_id string Required. The unique click identifier (use {clickid} macro in your affiliate URL).
conversion_value number Optional. Sale amount in USD (for ROI calculation).
event_type string Optional. Type of conversion: sale, lead, signup. Default: sale

Example Request

{
    "campaign_id": 145,
    "click_id": "7f8a9b2c3d4e5f6g",
    "conversion_value": 49.99,
    "event_type": "sale"
}

Success Response

{
    "status": 200,
    "msg": "Conversion tracked successfully",
    "data": {
        "conversion_id": "cv_89a7b6c5d4e3f2g1",
        "credits_earned": 10,
        "total_conversions_this_campaign": 51
    }
}

Implementation Tips

  • Add ?clickid={clickid} to your affiliate URLs when creating campaigns
  • Use server-side postback from your affiliate network or CRM
  • Report conversions within 30 days of the original click
  • Higher conversion rates = Better targeting in future campaigns
🎯 Why Report Conversions?
  • Earn up to 0.1% credit cashback (category-based rates)
  • Help us identify high-quality subscribers
  • Improve targeting for your future campaigns
  • Get priority placement in our sending queue

Error Codes

Code Message Description
300 Insufficient credits Your account balance is too low for this campaign.
400 Bad Request Missing required fields or invalid URL format.
401 Unauthorized Invalid or missing API key.
429 Rate Limit Exceeded Too many requests. Limit is 60 requests/minute.