# Error in API documentation for POST /meetings/id/registrants

**URL:** <https://devforum.zoom.us/t/error-in-api-documentation-for-post-meetings-id-registrants/22820>\
**Category:** API and Webhooks\
**Created:** [June 30, 2020, 9:59pm UTC](https://devforum.zoom.us/t/error-in-api-documentation-for-post-meetings-id-registrants/22820 "2020-06-30T21:59:41Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![diegoj](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/diegoj/32/11249_2.png) [@diegoj](https://devforum.zoom.us/u/diegoj)\
**Post date:** [June 30, 2020, 9:59pm UTC](https://devforum.zoom.us/t/error-in-api-documentation-for-post-meetings-id-registrants/22820/1 "2020-06-30T21:59:41Z")

</div>

**Description**  
The documentation is wrong. In this page:  
/docs/api-reference/zoom-api/meetings/meetingregistrantcreate

… there are not Paid account requirements. However, when I execute that API I get:

```auto
{
      "code": 200,
      "message": "Only available for paid users: grSTL45BQgOxKKlig-IR6A."
}

```

Obviously registering participants is a Pro feature, which sucks since I thought I was going to be able to do it when reading the documentation.

**Error**

```auto
{
      "code": 200,
      "message": "Only available for paid users: grSTL45BQgOxKKlig-IR6A."
}

```

when executing  
`POST /meetings/{meetingId}/registrants`

**Which App Type (OAuth / Chatbot / JWT / Webhook)?**  
OAuth

**Which Endpoint/s?**  
(shown in steps to reproduce, the forum doesn’t let me add another link)

**How To Reproduce (If applicable)**  
Steps to reproduce the behavior:

1. On a free account, when building an OAuth application
2. Run the following:

```auto
    curl --location --request POST 'https://api.zoom.us/v2/meetings/93207074945/registrants' \
    --header 'Content-Type: application/json' \
    --header 'Accept: application/json' \
    --header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXXX' \
    --data-raw '{"email":"1593552283186@gmail.com", "first_name":"John 1593552283186", "comments":"1593552283186"}'

```

1. That API endpoint doesn’t have the Pro account as a prerequisite.

---

<div class="post-metadata">

**Author:** ![diegoj](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/diegoj/32/11249_2.png) [@diegoj](https://devforum.zoom.us/u/diegoj)\
**Post date:** [June 30, 2020, 10:14pm UTC](https://devforum.zoom.us/t/error-in-api-documentation-for-post-meetings-id-registrants/22820/2 "2020-06-30T22:14:25Z")

</div>

Follow up question. When someone joins, is there any way to pass some information to identify the attendee? I’m capturing the webhooks and I only get the name they type. I need a way to identify who’s joining besides their name. (using only APIs for free accounts)

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [July 1, 2020, 11:52pm UTC](https://devforum.zoom.us/t/error-in-api-documentation-for-post-meetings-id-registrants/22820/3 "2020-07-01T23:52:13Z")

</div>

Hey @diegoj,

We will update the docs to mention you need a paid account to register users to your meeting. CC @shrijana.g

> [@diegoj](#):
>
> When someone joins, is there any way to pass some information to identify the attendee? I’m capturing the webhooks and I only get the name they type. I need a way to identify who’s joining besides their name. (using only APIs for free accounts)

You can use the Get Past Meeting Participants endpoint which includes the email of the participant if they registered for your meeting or were logged in when joining:

[https://marketplace.zoom.us/docs/api-reference/zoom-api/meetings/pastmeetingparticipants](https://marketplace.zoom.us/docs/api-reference/zoom-api/meetings/pastmeetingparticipants)

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![diegoj](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/diegoj/32/11249_2.png) [@diegoj](https://devforum.zoom.us/u/diegoj)\
**Post date:** [July 2, 2020, 1:07am UTC](https://devforum.zoom.us/t/error-in-api-documentation-for-post-meetings-id-registrants/22820/4 "2020-07-02T01:07:20Z")

</div>

Thank you.  
Can you tell me how to add the scope “`meeting:read:admin`”? When I edit the scopes in the OAuth app I only have `meeting:read` and `meeting:write`. Thanks

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [July 6, 2020, 6:46pm UTC](https://devforum.zoom.us/t/error-in-api-documentation-for-post-meetings-id-registrants/22820/5 "2020-07-06T18:46:21Z")

</div>

Hey @diegoj,

You will need to create an [Account Level OAuth app](https://marketplace.zoom.us/develop/create).

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![DeveloperBot](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/developerbot/32/12632_2.png) [@DeveloperBot](https://devforum.zoom.us/u/DeveloperBot)\
**Post date:** [August 21, 2020, 10:34pm UTC](https://devforum.zoom.us/t/error-in-api-documentation-for-post-meetings-id-registrants/22820/6 "2020-08-21T22:34:38Z")

</div>

Closed on August 21, 2020, 10:34pm UTC