curl --request POST \
--url https://api.convertixapp.com/api/v1/client \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"leadReference": "<string>",
"phoneNumber": "<string>",
"name": "<string>",
"email": "<string>",
"externalReference": "<string>"
}
'import requests
url = "https://api.convertixapp.com/api/v1/client"
payload = {
"leadReference": "<string>",
"phoneNumber": "<string>",
"name": "<string>",
"email": "<string>",
"externalReference": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
leadReference: '<string>',
phoneNumber: '<string>',
name: '<string>',
email: '<string>',
externalReference: '<string>'
})
};
fetch('https://api.convertixapp.com/api/v1/client', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.convertixapp.com/api/v1/client",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'leadReference' => '<string>',
'phoneNumber' => '<string>',
'name' => '<string>',
'email' => '<string>',
'externalReference' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.convertixapp.com/api/v1/client"
payload := strings.NewReader("{\n \"leadReference\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"name\": \"<string>\",\n \"email\": \"<string>\",\n \"externalReference\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.convertixapp.com/api/v1/client")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"leadReference\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"name\": \"<string>\",\n \"email\": \"<string>\",\n \"externalReference\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.convertixapp.com/api/v1/client")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"leadReference\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"name\": \"<string>\",\n \"email\": \"<string>\",\n \"externalReference\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": 123
}{
"message": "<string>"
}{
"message": "<string>"
}Crear un nuevo cliente
Crea un nuevo cliente usando una API key.
Requisitos:
Esta operación requiere una referencia de lead obtenida de un redirect de landing page mediante el campo leadReference.
Comportamiento:
Si se proporciona externalReference y ya existe un cliente con esa referencia, se devolverá el ID del cliente existente en lugar de crear uno nuevo.
curl --request POST \
--url https://api.convertixapp.com/api/v1/client \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"leadReference": "<string>",
"phoneNumber": "<string>",
"name": "<string>",
"email": "<string>",
"externalReference": "<string>"
}
'import requests
url = "https://api.convertixapp.com/api/v1/client"
payload = {
"leadReference": "<string>",
"phoneNumber": "<string>",
"name": "<string>",
"email": "<string>",
"externalReference": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
leadReference: '<string>',
phoneNumber: '<string>',
name: '<string>',
email: '<string>',
externalReference: '<string>'
})
};
fetch('https://api.convertixapp.com/api/v1/client', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.convertixapp.com/api/v1/client",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'leadReference' => '<string>',
'phoneNumber' => '<string>',
'name' => '<string>',
'email' => '<string>',
'externalReference' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.convertixapp.com/api/v1/client"
payload := strings.NewReader("{\n \"leadReference\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"name\": \"<string>\",\n \"email\": \"<string>\",\n \"externalReference\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.convertixapp.com/api/v1/client")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"leadReference\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"name\": \"<string>\",\n \"email\": \"<string>\",\n \"externalReference\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.convertixapp.com/api/v1/client")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"leadReference\": \"<string>\",\n \"phoneNumber\": \"<string>\",\n \"name\": \"<string>\",\n \"email\": \"<string>\",\n \"externalReference\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": 123
}{
"message": "<string>"
}{
"message": "<string>"
}Authorizations
Body
Referencia del lead obtenida del redirect de la landing page, ejemplo: "LD_1234ADD"
Número de teléfono del cliente
Nombre completo del cliente
Email del cliente
Referencia externa del cliente, esta referencia es algo que puedes usar para identificar al cliente en tu sistema, si un cliente ya está creado con la misma referencia externa vamos a devolver el mismo ID de cliente
Response
Cliente creado exitosamente o ID de cliente existente devuelto
ID del cliente
Was this page helpful?