1100: Create lead

Creates a new Lead entity. The leadSourceID and all fields are configured within the Rubiq Lead Management app.
Endpoint ID:

1100

Method
POST
URL:

/entity/lead/{leadSourceID}


leadSourceID

A GUID identifying the type of Lead to create

Request body:

JSON data with properties corresponding to the fields in the specified Lead type

keys: Required. Uniquely identifiable keys for the lead, configured in the Rubiq Lead Management app.

data: Optional. Lead entity data fields, configured in the Rubiq Lead Management app. Note that this property is only optional as long as no required data fields have been configured.

context: Optional. Extra information about where this lead has come from, e.g. pageUrl, ticket, popupName, partnerName, employeeName, ...

{
	"keys": {
        "email": "mailbox@mailserver.com",
        "mobile": "123 456 789"
    },
	"data": {
        "name": "John Doe",
        "address": "1 Harbour Tce., Townsville"
    },
	"context": {
        "pageUrl": "https://domain.org/lead/generation",
        "campaignID": "f3ff7b9a-c57c-409b-8d6a-8d6c44640f0e"
    }
}

Response body:

The Rubiq ID of the newly created lead entity is returned, unless the lead source has been configured to not create entities, in which case an empty JSON block { } is returned.

{
	"id": 12345
}
Status codes:

HttpStatusCode
ApiStatusSubCode
Description
200
Lead created
400

Request is valid but data validation failed

400.1Inactive leadSourceID
400.3Required keys field missing
400.4Required data field missing
400.5Required context field missing
404404.4

leadSourceID not found