Log a Meeting

curl --request POST \
  --url https://api.getnexor.ai/api/public/meetings \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "lead_email": "tony.stark@gmail.com",
  "title": "Discovery Call with Tony Stark",
  "starts_at": "2025-12-29T17:00:00Z",
  "duration_minutes": 60,
  "timezone": "America/Santiago",
  "meeting_url": "https://meet.google.com/oki-fjnk-oyu",
  "status": "confirmed",
  "external_calendar_provider": "ghl",
  "external_event_id": "1RZJ24WY65VGQFyhN0vJ"
}
'

import requests

url = "https://api.getnexor.ai/api/public/meetings"

payload = {
    "lead_email": "tony.stark@gmail.com",
    "title": "Discovery Call with Tony Stark",
    "starts_at": "2025-12-29T17:00:00Z",
    "duration_minutes": 60,
    "timezone": "America/Santiago",
    "meeting_url": "https://meet.google.com/oki-fjnk-oyu",
    "status": "confirmed",
    "external_calendar_provider": "ghl",
    "external_event_id": "1RZJ24WY65VGQFyhN0vJ"
}
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({
    lead_email: 'tony.stark@gmail.com',
    title: 'Discovery Call with Tony Stark',
    starts_at: '2025-12-29T17:00:00Z',
    duration_minutes: 60,
    timezone: 'America/Santiago',
    meeting_url: 'https://meet.google.com/oki-fjnk-oyu',
    status: 'confirmed',
    external_calendar_provider: 'ghl',
    external_event_id: '1RZJ24WY65VGQFyhN0vJ'
  })
};

fetch('https://api.getnexor.ai/api/public/meetings', 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.getnexor.ai/api/public/meetings",
  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([
    'lead_email' => 'tony.stark@gmail.com',
    'title' => 'Discovery Call with Tony Stark',
    'starts_at' => '2025-12-29T17:00:00Z',
    'duration_minutes' => 60,
    'timezone' => 'America/Santiago',
    'meeting_url' => 'https://meet.google.com/oki-fjnk-oyu',
    'status' => 'confirmed',
    'external_calendar_provider' => 'ghl',
    'external_event_id' => '1RZJ24WY65VGQFyhN0vJ'
  ]),
  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.getnexor.ai/api/public/meetings"

	payload := strings.NewReader("{\n  \"lead_email\": \"tony.stark@gmail.com\",\n  \"title\": \"Discovery Call with Tony Stark\",\n  \"starts_at\": \"2025-12-29T17:00:00Z\",\n  \"duration_minutes\": 60,\n  \"timezone\": \"America/Santiago\",\n  \"meeting_url\": \"https://meet.google.com/oki-fjnk-oyu\",\n  \"status\": \"confirmed\",\n  \"external_calendar_provider\": \"ghl\",\n  \"external_event_id\": \"1RZJ24WY65VGQFyhN0vJ\"\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.getnexor.ai/api/public/meetings")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"lead_email\": \"tony.stark@gmail.com\",\n  \"title\": \"Discovery Call with Tony Stark\",\n  \"starts_at\": \"2025-12-29T17:00:00Z\",\n  \"duration_minutes\": 60,\n  \"timezone\": \"America/Santiago\",\n  \"meeting_url\": \"https://meet.google.com/oki-fjnk-oyu\",\n  \"status\": \"confirmed\",\n  \"external_calendar_provider\": \"ghl\",\n  \"external_event_id\": \"1RZJ24WY65VGQFyhN0vJ\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getnexor.ai/api/public/meetings")

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  \"lead_email\": \"tony.stark@gmail.com\",\n  \"title\": \"Discovery Call with Tony Stark\",\n  \"starts_at\": \"2025-12-29T17:00:00Z\",\n  \"duration_minutes\": 60,\n  \"timezone\": \"America/Santiago\",\n  \"meeting_url\": \"https://meet.google.com/oki-fjnk-oyu\",\n  \"status\": \"confirmed\",\n  \"external_calendar_provider\": \"ghl\",\n  \"external_event_id\": \"1RZJ24WY65VGQFyhN0vJ\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "meeting": {
    "id": "event-uuid",
    "lead_id": "lead-uuid",
    "title": "Discovery Call with Tony Stark",
    "starts_at": "2025-12-29T17:00:00Z",
    "ends_at": "2025-12-29T18:00:00Z",
    "duration_minutes": 60,
    "timezone": "America/Santiago",
    "status": "confirmed",
    "meeting_url": "https://meet.google.com/oki-fjnk-oyu",
    "location_type": "video",
    "location_details": null,
    "host_name": null,
    "meeting_type": null,
    "attendee_name": "Tony Stark",
    "attendee_email": "tony.stark@gmail.com",
    "external_calendar_provider": "ghl",
    "external_event_id": "1RZJ24WY65VGQFyhN0vJ",
    "source": "api",
    "created_at": "2026-04-15T12:00:00Z"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

POST

meetings

Log a Meeting

curl --request POST \
  --url https://api.getnexor.ai/api/public/meetings \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "lead_email": "tony.stark@gmail.com",
  "title": "Discovery Call with Tony Stark",
  "starts_at": "2025-12-29T17:00:00Z",
  "duration_minutes": 60,
  "timezone": "America/Santiago",
  "meeting_url": "https://meet.google.com/oki-fjnk-oyu",
  "status": "confirmed",
  "external_calendar_provider": "ghl",
  "external_event_id": "1RZJ24WY65VGQFyhN0vJ"
}
'

import requests

url = "https://api.getnexor.ai/api/public/meetings"

payload = {
    "lead_email": "tony.stark@gmail.com",
    "title": "Discovery Call with Tony Stark",
    "starts_at": "2025-12-29T17:00:00Z",
    "duration_minutes": 60,
    "timezone": "America/Santiago",
    "meeting_url": "https://meet.google.com/oki-fjnk-oyu",
    "status": "confirmed",
    "external_calendar_provider": "ghl",
    "external_event_id": "1RZJ24WY65VGQFyhN0vJ"
}
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({
    lead_email: 'tony.stark@gmail.com',
    title: 'Discovery Call with Tony Stark',
    starts_at: '2025-12-29T17:00:00Z',
    duration_minutes: 60,
    timezone: 'America/Santiago',
    meeting_url: 'https://meet.google.com/oki-fjnk-oyu',
    status: 'confirmed',
    external_calendar_provider: 'ghl',
    external_event_id: '1RZJ24WY65VGQFyhN0vJ'
  })
};

fetch('https://api.getnexor.ai/api/public/meetings', 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.getnexor.ai/api/public/meetings",
  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([
    'lead_email' => 'tony.stark@gmail.com',
    'title' => 'Discovery Call with Tony Stark',
    'starts_at' => '2025-12-29T17:00:00Z',
    'duration_minutes' => 60,
    'timezone' => 'America/Santiago',
    'meeting_url' => 'https://meet.google.com/oki-fjnk-oyu',
    'status' => 'confirmed',
    'external_calendar_provider' => 'ghl',
    'external_event_id' => '1RZJ24WY65VGQFyhN0vJ'
  ]),
  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.getnexor.ai/api/public/meetings"

	payload := strings.NewReader("{\n  \"lead_email\": \"tony.stark@gmail.com\",\n  \"title\": \"Discovery Call with Tony Stark\",\n  \"starts_at\": \"2025-12-29T17:00:00Z\",\n  \"duration_minutes\": 60,\n  \"timezone\": \"America/Santiago\",\n  \"meeting_url\": \"https://meet.google.com/oki-fjnk-oyu\",\n  \"status\": \"confirmed\",\n  \"external_calendar_provider\": \"ghl\",\n  \"external_event_id\": \"1RZJ24WY65VGQFyhN0vJ\"\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.getnexor.ai/api/public/meetings")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"lead_email\": \"tony.stark@gmail.com\",\n  \"title\": \"Discovery Call with Tony Stark\",\n  \"starts_at\": \"2025-12-29T17:00:00Z\",\n  \"duration_minutes\": 60,\n  \"timezone\": \"America/Santiago\",\n  \"meeting_url\": \"https://meet.google.com/oki-fjnk-oyu\",\n  \"status\": \"confirmed\",\n  \"external_calendar_provider\": \"ghl\",\n  \"external_event_id\": \"1RZJ24WY65VGQFyhN0vJ\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getnexor.ai/api/public/meetings")

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  \"lead_email\": \"tony.stark@gmail.com\",\n  \"title\": \"Discovery Call with Tony Stark\",\n  \"starts_at\": \"2025-12-29T17:00:00Z\",\n  \"duration_minutes\": 60,\n  \"timezone\": \"America/Santiago\",\n  \"meeting_url\": \"https://meet.google.com/oki-fjnk-oyu\",\n  \"status\": \"confirmed\",\n  \"external_calendar_provider\": \"ghl\",\n  \"external_event_id\": \"1RZJ24WY65VGQFyhN0vJ\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "meeting": {
    "id": "event-uuid",
    "lead_id": "lead-uuid",
    "title": "Discovery Call with Tony Stark",
    "starts_at": "2025-12-29T17:00:00Z",
    "ends_at": "2025-12-29T18:00:00Z",
    "duration_minutes": 60,
    "timezone": "America/Santiago",
    "status": "confirmed",
    "meeting_url": "https://meet.google.com/oki-fjnk-oyu",
    "location_type": "video",
    "location_details": null,
    "host_name": null,
    "meeting_type": null,
    "attendee_name": "Tony Stark",
    "attendee_email": "tony.stark@gmail.com",
    "external_calendar_provider": "ghl",
    "external_event_id": "1RZJ24WY65VGQFyhN0vJ",
    "source": "api",
    "created_at": "2026-04-15T12:00:00Z"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

To change a meeting’s outcome later, use the dedicated endpoints: Mark as No-show, Cancel, and Mark as Completed. Lead matching. Leads are matched by email, scoped to your client. If one lead matches it is used; if multiple share the email the most recently updated wins; if none match you get a 404 (create the lead first via POST /leads). Pass lead_id directly to skip email matching. Idempotency. If you supply both external_calendar_provider and external_event_id, replaying the request updates the existing meeting instead of creating a duplicate. Safe for webhook retries.

Authorizations

X-API-Key

string

header

required

API key for authentication. Keys are prefixed with nxr_live_.

Body

application/json

title

string

required

Meeting title.

starts_at

string

required

ISO 8601. If no offset, interpreted in timezone.

lead_email

string

Matcher. Not required if lead_id is provided.

lead_id

string<uuid>

Bypass email matching.

ends_at

string

ISO 8601. Required unless duration_minutes is given.

duration_minutes

integer

Required unless ends_at is given.

timezone

string

IANA tz, default UTC (e.g. America/Santiago).

meeting_url

string

Meet / Zoom / Teams link.

location_type

enum<string>

default:video

Available options:

video,

phone,

in_person

location_details

string

description

string

host_email

string

Host user email (must be active in your client).

meeting_type_id

string<uuid>

attendee_name

string

Defaults to lead's full name.

attendee_email

string

Defaults to matched email.

attendee_phone

string

Defaults to lead's phone.

additional_attendees

object[]

Show child attributes

external_calendar_provider

string

e.g. ghl, google, calendly.

external_event_id

string

Provider's event id (enables dedup).

status

enum<string>

default:scheduled

Available options:

scheduled,

confirmed

Response

Meeting created

success

boolean

meeting

object

Show child attributes

Last modified on June 26, 2026

Quick Start

WhatsApp

Agents

Assistant

Advanced

API Reference

Leads

Agents

Workflow Tools

Client Tools

Groups

Campaigns

Conversions

Reports

Tags

Messages

Background Jobs

Meetings

Team

Processors

Log a Meeting

Authorizations

Body

Response