Marketiga

Connect with your favourite apps

Using Marketiga with Zapier and other Integrations

You can connect Marketiga to thousands of other apps with Zapier or build custom integrations using our REST API. This allows you to automate workflows, such as:

  • Adding a new candidate in Marketiga when a new row is added to a Google Sheet.
  • Creating a new card in Trello when a candidate submits a video.
  • Sending a Slack notification for new submissions.

Connecting to Zapier

When you add the Marketiga app to a Zap in Zapier, you will be prompted to connect your Marketiga account.

  1. A new window will open, asking you to log in to your Marketiga account.
  2. After logging in, you will be asked to authorize Zapier to access your Marketiga data.
  3. Click Authorize to grant access. The authorization window will close, and your account will be connected to Zapier.

This process uses OAuth2, which is a secure and standard way to connect applications without sharing your password. Zapier will be able to access your data based on the permissions you grant, such as reading campaigns or creating candidates.

Using the REST API with API Keys

For custom integrations or scripts, you can use a personal API key to authenticate with our REST API.

Finding Your API Key

  1. Log in to your Marketiga account (Admin or Owner role is needed).
  2. Navigate to Settings → Integrations.
  3. In the API Keys section, you can view, create, or revoke keys.
  4. Copy the key (it will start with mk_live_...) to use in your application.

Important: Treat your API keys like passwords. Do not share them publicly or commit them to version control.

Making API Requests

To authenticate your API requests, include your API key in the Authorization header as a Bearer token.

plaintextAuthorization: Bearer mk_live_YOUR_API_KEY

The base URL for all API endpoints is: https://[your-domain.com]/api/v1/

Available API Endpoints

Here are some of the main endpoints available:

Candidates

  • GET /api/v1/candidates/ – List all candidates in your workspace.
  • POST /api/v1/candidates/ – Create a new candidate.
  • PATCH /api/v1/candidates/{id}/ – Update an existing candidate.

Campaigns

  • GET /api/v1/campaigns/ – List all campaigns (useful for populating dropdowns in other apps).
  • POST /api/v1/campaigns/{id}/candidates/ – Add an existing candidate to a campaign. You can optionally trigger an invitation email by setting send_invitation: true in the request body.

Tags

  • GET /api/v1/tags/ – List all tags in your workspace.

Events (for Polling Triggers)

  • GET /api/v1/events/?since={ISO8601_TIMESTAMP} – Poll for new events to trigger workflows. This is how Zapier’s “New Video Submission” trigger works.
    • Example: GET /api/v1/events/?since=2023-10-27T10:00:00Z
    • Supported events include candidate.created, submission.created, and video.submitted.

Common Problems & Troubleshooting

  • “401 Unauthorized” Error: This means your API key is invalid or missing. Double-check that you have included the Authorization: Bearer ... header correctly and that the key is active in your Marketiga settings. If using OAuth2, try reconnecting your account in Zapier.
  • “403 Forbidden/Permission Denied” Error: Your user role (e.g., ‘View’ only) may not have permission to perform the requested action. Please contact your workspace Owner or Admin.
  • Zapier Connection Expired: If your Zap stops working, your authorization may have expired. Go to your connected accounts in Zapier and reconnect your Marketiga account.

If you have any other questions, please don’t hesitate to contact our support team.