Welcome to Dash Marketing

Dash Marketing provides a comprehensive platform for managing your locations, collecting leads, tracking analytics, and building custom landing pages. Our API enables you to integrate Dash Marketing’s powerful features directly into your applications, websites, and third-party tools.

Getting Started

Base URL

All API requests should be made to:

https://api.dashmarketing.io

Authentication

All API endpoints require authentication using an API key. Include your API key in the request headers:

X-API-KEY: your_api_key_here

Obtaining an API Key

Option 1: Request from Dash Marketing Contact your Dash Marketing representative at support@dashmarketing.io to request an API key for your organization.

Option 2: Create Your Own in Dash Core

  1. Log in to Dash Core
  2. Navigate to Organization Settings > API Keys
  3. Click Create New API Key
  4. Copy and store the key securely (it will only be shown once)

Security Best Practices

Available API Endpoints

Lead Management

Lead Submission API →

Submit leads to your Dash Core locations programmatically. Perfect for:

Key Features:

Quick Example:

curl -X POST https://api.dashmarketing.io/lead/submit \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key_here" \
  -d '{
    "email": "customer@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "locationUuid": "your-location-uuid",
    "source": "Website",
    "metadata": {
      "customField": "value"
    }
  }'

View Full Documentation →

Coming Soon

Additional API endpoints are in development and will be documented here as they become available:

Contact Management API

Manage contacts across your organization, update contact information, and track customer interactions.

Location API

Retrieve location information, search locations, and manage location data.

Analytics API

Access lead analytics, conversion metrics, and performance data for your locations.

Page Management API

Create and manage landing pages programmatically.

API Standards

Request Format

All requests must include:

Response Format

All responses return JSON with the following structure:

Success Response:

{
  "success": true,
  "message": "Operation completed successfully",
  "data": { ... },
  "timestamp": "2025-12-04T10:30:00.000Z"
}

Error Response:

{
  "success": false,
  "message": "Error description",
  "errors": ["Error detail 1", "Error detail 2"],
  "timestamp": "2025-12-04T10:30:00.000Z"
}

HTTP Status Codes

Code Description
200 Success
400 Bad Request - Invalid parameters or validation error
401 Unauthorized - Missing or invalid authentication
403 Forbidden - Valid authentication but insufficient permissions
404 Not Found - Resource doesn’t exist
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error - Something went wrong on our end

Rate Limiting

All API endpoints are subject to rate limiting to ensure fair usage:

If you need higher rate limits for your use case, contact support@dashmarketing.io.

Data Types and Formats

UUIDs

Locations, organizations, leads, and other resources are identified by UUIDs (Universally Unique Identifiers):

Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

Dates and Timestamps

All dates and timestamps use ISO 8601 format in UTC:

Format: YYYY-MM-DDTHH:mm:ss.sssZ
Example: 2025-12-04T10:30:00.000Z

Phone Numbers

Phone numbers should include country code:

Format: +1-555-123-4567 or +15551234567

Email Addresses

Standard email format:

Format: user@domain.com

Webhooks

Webhook support is coming soon. Webhooks will allow you to receive real-time notifications for events such as:

Stay tuned for webhook documentation.

Support and Resources

Contact Support

Email: support@dashmarketing.io

Response Times:

Support Includes:

Best Practices

Error Handling

Always implement proper error handling:

try {
  const response = await fetch('https://api.dashmarketing.io/lead/submit', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-KEY': apiKey
    },
    body: JSON.stringify(leadData)
  });

  if (!response.ok) {
    const error = await response.json();
    console.error('API Error:', error);
    // Handle specific error cases
    if (response.status === 429) {
      // Rate limited - implement backoff
    } else if (response.status === 400) {
      // Validation error - check form data
    }
  }

  const result = await response.json();
  return result;
} catch (error) {
  console.error('Network Error:', error);
  // Handle network errors
}

Retry Logic

Implement exponential backoff for transient failures:

async function submitWithRetry(data, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await submitLead(data);
    } catch (error) {
      if (i === maxRetries - 1) throw error;
      const delay = Math.pow(2, i) * 1000; // 1s, 2s, 4s
      await new Promise(resolve => setTimeout(resolve, delay));
    }
  }
}

Testing

Test your integration thoroughly:

  1. Test with valid data - Ensure successful submissions work
  2. Test with invalid data - Verify error handling
  3. Test rate limiting - Ensure backoff logic works
  4. Test network failures - Simulate connection issues
  5. Test different scenarios - Various form fields, metadata combinations

Terms of Service

By using the Dash Marketing API, you agree to:

For full Terms of Service, visit: https://www.dashmarketing.io/terms

Privacy and Data Protection

Dash Marketing is committed to protecting user data:

For our full Privacy Policy, visit: https://www.dashmarketing.io/privacy

Feedback

We’re constantly improving our API. Share your feedback:

Your input helps us build better tools for your business.

Last Updated: December 2025

Version: 1.0