API

Authentication

Authentication is OAuth2 based. We use AWS Cognito. Refer this url to know how it works

Ask us for the client_id and client_secret by sending an email to support@7targets.com

Get access token

Get a Base64 encoded string of client_id and client_secret.

echo -n 'client_id:client_secret' | openssl base64

Once you have the base64 encoded, you can request the access token with HTTP Basic Authorization header. Like below.

curl -X POST https://7targets-prod.auth.us-east-1.amazoncognito.com/oauth2/token -H 'authorization: Basic ***********iMWl0NmYsdsdsdsdIyYTJ******HRjYm9yZGtucHR0Z2U0azI248csfderdfZhZ3J***************' -H 'content-type: application/x-www-form-urlencoded' -d 'grant_type=client_credentials&scope=leads%2Fpost'

This should return an access_token, which is a JWT.

{
    "access_token": "*********eyJzdWIiOiIxNGtJU-QMfeFJkN2UgKQ*",
    "expires_in": 3600,
    "token_type": "Bearer"
}

Create a Lead

This method creates or assigns a Lead to the Assistant.

url_path: https://api.7targets.com/leads
type: POST

Authorization Header for the API calls
Authorization : Bearer <access_token>

Request

The headers must include a **valid access_token.
Authentication: Bearer <access_token>

The body can’t be empty

{
    name: "John",  //Mandatory
    lastName: "Doe", 
    source: "Website", //Optional. If not provided Website will be used.
    context: "AI Sales Assistant", //Assistant will write message using this
    additionalInformationLine: "Additional information", 
    email: "john.doe@gmail.com", //Mandatory 
    phone: "+919123456789", //Optional
    assistantEmail : <assistant email to assign> //Mandatory.
    scheduleId : <valid schedule Id>, //Optional. If not provided then use default for the assistant
}

Response

If succeeds, returns the created Lead.

Status: 201 Created

{
    id: 2345,
    name: "John",   
    lastName: "Doe", 
    type: "SALES", 
    email: "john.doe@gmail.com", 
    phone: "+919123456789", 
    scheduleId : <valid schedule Id>,
    assistantId : <your assistant Id>,
    nextScheduleTime : <date and time the message will be send>,
    state : Cold,
    subState : Followup,
    followup : 1
}
×

Subscribe

The latest tutorials sent straight to your inbox.