API Overview

The Marketing Lead Automation Service exposes a GraphQL API for partners to submit leads, track processing status, and receive qualification results.

GraphQL Endpoint

POST /graphql

Authentication

All requests require a valid Bearer token in the Authorization header:

Authorization: Bearer {ACCESS_TOKEN}

See the Authentication Guide for details on obtaining tokens.

Available Operations

Queries

1 read operation available

Mutations

2 write operations available

Mutations

Operation	Description
createLead	Submit a new lead with applicant information for processing and qualification.

This mutation initiates the lead processing pipeline including:

• Deduplication check

• TrustedForm verification (if certificate ID provided)

• Monevo Credit pull and eligibility scoring

• Bid calculation for qualified leads

• Can also be configured to skip all validation

  createLead waits for workflow completion and returns the completed result. Processing behavior and CRM submission path are internally configured based on lead partner requirements. | | submitLead | Submit a qualified lead to the CRM system for enrollment.

Use this mutation after receiving a qualified result code (1013-1017) from createLead when your partner configuration requires manual CRM submission.

Returns the CRM record ID on success. |

Queries

Operation	Description
getLeadStatus	Query the current status and result code of a previously submitted lead.

Use this query to check the status of older leads and for reconciliation or troubleshooting. The response includes the current result code and bid value (if applicable). |