How to add invitees when creating meeting via API

What is the proper way for attaching the invitee(s) to a meeting when created via the API?

You documentation ( states there is a settings parameter to add “meeting_invitees” which should be an array object of emails inside the settings parameter, i am getting back error with this payload:

  "topic": "test meeting",
  "type": "2",
  "start_time": "2022-02-01T19:00:00+00:00",
  "duration": "30",
  "timezone": "UTC",
  "password": "string1",
  "agenda": "This is the agenda text",
  "settings": {
    "meeting_invitees": [
    "alternative_hosts": "",
    "alternative_hosts_email_notification": "false",
    "registrants_email_notification": "true",
    "registrants_confirmation_email": "true"


    <message>Request Body should be a valid JSON object.</message>

Hi @bk-zoom ,

I was able to reproduce this error as well. I’ve opened up an inquiry with our API engineers (ZOOM-338682). I’ll keep you updated!


@bk-zoom hello this is my fault, it should be an array of objects like this:

“settings”: {
“meeting_invitees”: [
{“email”: “”}, {“email”: “”}

Hi Gianni,

When the meeting is created, is it supposed to send an invitation email to all the given invitees? Because in my case, it does not.

Do I miss something?

Btw, here is how I create my payload:

const invitees = (this.meetingFormGroup.getRawValue().invitees as string)?.split(';').map(i => ({ email: i })) || [];

const meetingPayload: Partial<MeetingPayload> = {
  topic: this.meetingFormGroup.getRawValue().topic,
  agenda: this.meetingFormGroup.getRawValue().agenda,
  type: MeetingType.RECURRING_NO_FIXED_TIME,
  password: '', // will be set automatically by zoom API
  timezone: 'Europe/Paris',
  settings: {
    meeting_invitees: invitees,
    registrants_email_notification: true,
    registrants_confirmation_email: true,


Hi @jl-zoom ,

Check your email settings on your account for meetings. See if the box is checked. The API request with

registrants_email_notification: true,
registrants_confirmation_email: true,

Should be sufficient in enforcing this setting, but let me know what you see in your portal.

Hi @gianni.zoom,

Could you please be more specific about the box to check?

Those are the options I have:


Hi @jl-zoom ,

I am actually mistaken. It seems like you can only do this for webinars (see below):

I wasn’t able to access the same email settings for meetings. Can you please send your full API request url/body and response body with a link to this thread to Support addressed to me? Please also include the meetingId where the expected behavior is not occuring.

I will take a further look to see why its’s not working.

Thank you,

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.