Contacts - LetsLigo

POST /api/contacts

Create a contact

Exemple de requête

curl -X POST "https://www.letsligo.com/api/contacts" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{   "name": "Marie Dubois",   "emails": [     "[email protected]",     "[email protected]"   ],   "company": "Acme Corp" }'

Corps de la requête

{
    "name": "Marie Dubois",
    "emails": [
        "[email protected]",
        "[email protected]"
    ],
    "company": "Acme Corp"
}

Paramètres de la requête

Nom	Type	Description	Requis
name	string	Contact name (required)	Oui
emails	array	Email addresses only (one entry if there is a single address).	Non
company	string		Non
position	string		Non
phones	array	Phone numbers only (one entry if there is a single number).	Non
address	string		Non
website	string		Non
linkedinUrl	string		Non
additionalInfo	string		Non
meetingContext	string		Non

POST /api/contacts/confirm

Confirm contact creation (wizard)

Exemple de requête

curl -X POST "https://www.letsligo.com/api/contacts/confirm" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

Paramètres de la requête

Nom	Type	Description	Requis
confirmationToken	string		Oui
overrides	object	Last-minute field overrides	Non

POST /api/contacts/prepare

Prepare contact creation (wizard)

Exemple de requête

curl -X POST "https://www.letsligo.com/api/contacts/prepare" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

Paramètres de la requête

Nom	Type	Description	Requis
text	string	Raw text (signature, vCard) to extract contact from	Oui
overrides	object	Field overrides to correct/extend extracted data	Non

PATCH /api/contacts/{id}

Update a contact

Exemple de requête

curl -X PATCH "https://www.letsligo.com/api/contacts/123e4567-e89b-12d3-a456-426614174000" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{   "company": "Acme Corp",   "position": "Directrice",   "phones": [     "+33 6 00 00 00 00",     "+33 1 00 00 00 00"   ] }'

Corps de la requête

{
    "company": "Acme Corp",
    "position": "Directrice",
    "phones": [
        "+33 6 00 00 00 00",
        "+33 1 00 00 00 00"
    ]
}

Paramètres de la requête

Nom	Type	Description	Requis
id	string (uuid)	Identifiant unique (UUID) de la ressource.	Oui
name	string		Non
emails	array	Email addresses only (one entry if there is a single address).	Non
company	string		Non
position	string		Non
phones	array	Phone numbers only (one entry if there is a single number).	Non
address	string		Non
website	string		Non
linkedinUrl	string		Non
additionalInfo	string		Non
meetingContext	string		Non

POST /api/contacts/{id}/emails/prepare

Prepare / generate email

Exemple de requête

curl -X POST "https://www.letsligo.com/api/contacts/123e4567-e89b-12d3-a456-426614174000/emails/prepare" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{   "message": "Rédige un email de relance après notre rencontre au salon" }'

Corps de la requête

{
    "message": "Rédige un email de relance après notre rencontre au salon"
}

Paramètres de la requête

Nom	Type	Description	Requis
id	string (uuid)	Identifiant unique (UUID) de la ressource.	Oui
message	string	Instruction for email generation	Oui
sessionId	string (uuid)	Existing session ID for iterations	Non
currentEmail	object		Non

POST /api/contacts/{id}/emails/refine

Refine email

Exemple de requête

curl -X POST "https://www.letsligo.com/api/contacts/123e4567-e89b-12d3-a456-426614174000/emails/refine" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{   "instruction": "Raccourcis le paragraphe 2",   "sessionId": "uuid-from-prepare" }'

Corps de la requête

{
    "instruction": "Raccourcis le paragraphe 2",
    "sessionId": "uuid-from-prepare"
}

Paramètres de la requête

Nom	Type	Description	Requis
id	string (uuid)	Identifiant unique (UUID) de la ressource.	Oui
instruction	string	e.g. "Shorten paragraph 2"	Oui
sessionId	string (uuid)	Required - from prepare	Non
currentEmail	object		Non

POST /api/contacts/{id}/emails/send

Send email

Exemple de requête

curl -X POST "https://www.letsligo.com/api/contacts/123e4567-e89b-12d3-a456-426614174000/emails/send" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{   "sessionId": "uuid-from-prepare" }'

Corps de la requête

{
    "sessionId": "uuid-from-prepare"
}

Paramètres de la requête

Nom	Type	Description	Requis
id	string (uuid)	Identifiant unique (UUID) de la ressource.	Oui
emailData	object		Non
sessionId	string (uuid)		Non

POST /api/contacts/{id}/extend

Extend contact with text

Exemple de requête

curl -X POST "https://www.letsligo.com/api/contacts/123e4567-e89b-12d3-a456-426614174000/extend" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

Paramètres de la requête

Nom	Type	Description	Requis
id	string (uuid)	Identifiant unique (UUID) de la ressource.	Oui
text	string	Text to append	Oui
field	string: additionalInfo \| meetingContext		Non

PATCH /api/contacts/{id}/pipeline-state

Update contact pipeline state

Exemple de requête

curl -X PATCH "https://www.letsligo.com/api/contacts/123e4567-e89b-12d3-a456-426614174000/pipeline-state" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{   "stateId": "123e4567-e89b-12d3-a456-426614174000" }'

Corps de la requête

{
    "stateId": "123e4567-e89b-12d3-a456-426614174000"
}

Paramètres de la requête

Nom	Type	Description	Requis
id	string (uuid)	Contact UUID	Oui
stateId	string (uuid), nullable	Pipeline state UUID. Pass null or omit to remove contact from pipeline.	Non

Exemple de réponse

{
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Marie Dubois",
    "company": "Acme Corp",
    "status": "pending",
    "pipelineState": {
        "id": "223e4567-e89b-12d3-a456-426614174000",
        "name": "Nouveau contact"
    }
}

Attributs de la réponse

Nom	Type	Description
id	string (uuid)	Identifiant unique (UUID) de la ressource.
name	string	Nom complet du contact (obligatoire).
company	string, nullable	Nom de l'entreprise ou de l'organisation.
status	string: pending \| enriched \| contacted \| qualified \| converted \| lost	Statut du contact dans le pipeline : pending, enriched, contacted, qualified, converted ou lost.
pipelineState	object, nullable	État actuel du contact dans le pipeline.