Create and join meetings

Create a meeting

curl -X POST 'https://api.facemeet.net/v1/integration/meetings' \
  -H 'Authorization: Bearer YOUR_INTEGRATION_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Team Sync"}'

The request accepts title and optional scheduledStart, scheduledEnd (date/time values) and lobby (boolean). The response contains a meeting object. Use its id for subsequent requests. Organization plan limits and host policy apply.

Read or delete

• GET /v1/integration/meetings/{id} returns a meeting belonging to the integration's organization.
• DELETE /v1/integration/meetings/{id} deletes a meeting when deletion is permitted. Recordings can prevent deletion.

Create a join URL

POST /v1/integration/meetings/{id}/join
Content-Type: application/json
Authorization: Bearer YOUR_INTEGRATION_KEY

{"displayName":"Taylor","role":"guest"}

Optional email identifies the invited person. role is guest by default; host grants moderator access and should be issued only to trusted people. The response includes url, domain, roomName, and jwt. Treat host join URLs and JWTs as credentials. Generate join URLs on your server.