Helpdesk
RoadmapGo to MeltingSpot
English
English
  • To begin
    • 📝Introduction
    • 🗝️Key concepts
    • 👋Join a Spot
    • 🎯Create a Spot
  • Content of a Spot
    • 🏠Home page
    • ▶️Lives
      • ➕Create a live
      • ➕Create a replay
      • 👣Accessing the live's settings
      • ⚙️General settings
      • 🔓Privacy
      • 🎥Video Settings
      • ⚙️Live room settings
      • 💌Invitations & participants
      • 👥Manage guest groups
      • 🎙️Speakers
      • 📩Notifications
      • 🏷️Tags on lives
      • ✔️Register to a live
      • 📋Before starting a live
      • ⏸️Start a live
      • ⏯️Ending a live
      • 📊Live performance metrics
    • 🎓Courses
      • 📂Module
      • ➕Create a course
      • 👣Configuring steps
      • ⁉️Quiz
      • 🛣️Access course parameters
      • ⚙️General settings
      • 💌Invitations & participants
      • 👥Manage guest groups
      • 📩Notifications
      • ✏️Draft mode
      • 📋Take a course
    • 💬Discussions
      • 🔉Creating a channel
      • ⚙️Channel settings
      • ➕Adding and removing members of a channel
      • 🧰Forum
      • 👉Topics in Forums
      • ➕Adding and removing members of a secret forum
      • ⬆️Voting, sorting and searching in Topics
      • 📌Sharing, pinning and marking topic as closed
      • ⬇️Voting, sorting and pinning replies to a Topic
      • 🔔Forum notifications
      • 🖍️Writing a message
      • 👋Mentioning a member
      • ❌Editing or deleting a message
      • 🗣️Replying to a message
      • ❤️Reacting to a message
    • 📚Collections
      • 🆕Manage a collection
      • 🔐Managing members/groups of a private collection
      • 📃Create and delete a page
      • 🔗Add & remove a link
      • ✏️Draft mode
      • 🏷️Tags on documents
    • 👥Members directory
      • 📰Public profile of a member
      • 🤸‍♂️Members' activities
      • 🏷️Tags on members
    • 🗣️Direct messages
    • 🔍Search in Spot
  • Managing a Spot
    • ⚙️Accessing the settings
    • 📊Dashboard
      • 📈Overview
      • 🤿Activities
      • ▶️Lives
    • 👥Audience
      • 👥Members
        • 🎭Member's role
        • 🎓Member's status
        • 📩Invite new members
        • 🗃️Import members
        • 👀Track Registration Sources
        • 💬Bulk Message
        • 🌠Last activity date
        • 👾Custom properties
      • 🧑‍🤝‍🧑Groups
        • ✍️Static Group
        • 🤖Smart Group
      • 👤User rights
        • ⚙️Manage roles
        • 🧢Assign roles to members
        • 🤝Permissions
    • 🏷️Tags
    • 👀Moderation
    • ⚙️General settings
    • 🎨Customization
      • ✨Theme
      • 🏗️Modular Spot
      • 🧑‍💻Scripts
    • 📨Email notifications
    • ❓Registration form
    • 🔗Integrations
      • 🪝Webhooks
      • 🤖API Access
        • 🧑‍🏫REST API
        • 🔦Configuration
        • 🗃️Endpoints - Spot Members
        • 🗃️Endpoints - Lives
        • 🗃️Endpoints - Courses
        • 🗃️Endpoints - Channels
        • 🗃️Endpoints - Forums
        • 🗃️Endpoints - Topics
        • 🗃️Endpoints - Groups
        • 🗃️Endpoints - Tags
        • 🗃️Endpoints - Custom properties
        • 🗃️Endpoints - Search
        • 🗃️Endpoints - Notifications
    • 🧡HubSpot integration
    • 🔑Single Sign-On
    • 🧩Embed
    • 💁‍♂️Widget
      • 📚List of contents
      • 🎓Course
      • 📃Document
      • Page
      • 🧑‍🏫Implementation
  • User Settings
    • 🔔Notification management
      • 💌Email Digest
    • 👤Manage my profiles
    • 🙌Belonging to several Spots
    • 🔔Notification Center
  • Guides
    • 🧐Access MeltingSpot
    • ⏹️Add MeltingSpot to your phone/computer home screen
    • 🔥Create a HubSpot contact for each new Spot registration
    • ✨Notify the start of a live on Slack
    • 📅Send a google calendar invitation to new live participants
    • 🗒️Add new members of your Spot to a Google Sheet
    • ❔How to use the webhook Registration form answered
    • 🔗Embed a Google Form in a page of your Spot
    • 🐞Troubleshooting lives
    • 🐝Accessing your billing space
    • ❓FAQ
Propulsé par GitBook
Sur cette page

Cet article vous a-t-il été utile ?

  1. Managing a Spot
  2. Integrations
  3. API Access

Endpoints - Spot Members

PrécédentConfigurationSuivantEndpoints - Lives

Dernière mise à jour il y a 6 mois

Cet article vous a-t-il été utile ?

Invite a Spot member

Invite multiple Spot members

Get custom form answers for a Spot member

Update a Spot member

Get a Spot member

List Spot members

🔗
🤖
🗃️
get

Get custom form answers for a spot member

Paramètres de chemin
spotMemberIdstringRequis

The id of the spotMember

Paramètres de requête
pageinteger | nullableOptionnel

The page number in a paginated set of results

limitinteger | nullableOptionnel

The limit of results to be returned per page

questionLabel[contains]stringOptionnel

The question label of custom form answers to include in the result

Réponses
200
Custom form answers returned successfully
application/json
404
Custom form answers not found
get
GET /v1/spotMembers/{spotMemberId}/customFormAnswers HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*
{
  "items": [
    {
      "questionId": "text",
      "questionLabel": "text",
      "visibility": "text",
      "order": 1,
      "isRequired": true,
      "type": "Description",
      "possibleAnswers": [
        "text"
      ],
      "answers": [
        "text"
      ]
    }
  ],
  "total": 1
}
get

Get a spot member

Paramètres de chemin
spotMemberIdstringRequis

The id of the spotMember

Réponses
200
Spot member returned successfully
application/json
404
Spot member not found
get
GET /v1/spotMembers/{spotMemberId} HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*
{
  "id": "text",
  "spotId": "text",
  "userId": "text",
  "email": "text",
  "title": "text",
  "role": "Member",
  "customRoleId": "text",
  "status": "Accepted",
  "firstname": "text",
  "lastname": "text",
  "warnings": 1,
  "embedBaseUrls": {
    "default": "text",
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}
get

List Spot members

Paramètres de requête
pageinteger | nullableOptionnel

The page number in a paginated set of results

limitinteger | nullableOptionnel

The limit of results to be returned per page

email[in]string[]Optionnel

The emails of spot member to include in the result

firstname[in]string[]Optionnel

The firstnames of spot member to include in the result

lastname[in]string[]Optionnel

The lastnames of spot member to include in the result

customRoleId[eq]stringOptionnel

The custom role ID of Spot member

invitationDate[before]integerOptionnel

Spot members where invitation date is before a specific date (Unix timestamp format)

invitationDate[after]integerOptionnel

Spot members where invitation date is after a specific date (Unix timestamp format)

registrationDate[before]integerOptionnel

Spot members where registration date is before a specific date (Unix timestamp format)

registrationDate[after]integerOptionnel

Spot members where registration date is after a specific date (Unix timestamp format)

Réponses
200
Spot members returned successfully
application/json
400
Malformed payload
get
GET /v1/spotMembers HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*
{
  "items": [
    {
      "id": "text",
      "spotId": "text",
      "userId": "text",
      "email": "text",
      "title": "text",
      "role": "Member",
      "customRoleId": "text",
      "status": "Accepted",
      "firstname": "text",
      "lastname": "text",
      "warnings": 1,
      "embedBaseUrls": {
        "default": "text",
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "total": 1
}
  • Invite a Spot member
  • POST/v1/spotMembers
  • Invite multiple Spot members
  • POST/v1/spotMembers~bulkInvite
  • Get custom form answers for a Spot member
  • GET/v1/spotMembers/{spotMemberId}/customFormAnswers
  • Update a Spot member
  • PUT/v1/spotMembers/{spotMemberId}
  • Get a Spot member
  • GET/v1/spotMembers/{spotMemberId}
  • List Spot members
  • GET/v1/spotMembers
post

Invite a spot member

Corps
emailstringRequis

The email of the spot member

withEmailNotificationbooleanOptionnel

Set to true to send notification mail to each invited members

Default: false
Réponses
201
Spot member has been successfully invited
application/json
400
Malformed payload
post
POST /v1/spotMembers HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "email": "text",
  "withEmailNotification": false
}
{
  "id": "text",
  "spotId": "text",
  "userId": "text",
  "email": "text",
  "title": "text",
  "role": "Member",
  "customRoleId": "text",
  "status": "Accepted",
  "firstname": "text",
  "lastname": "text",
  "warnings": 1,
  "embedBaseUrls": {
    "default": "text",
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}
post

Invite multiple spot members

Corps
emailsstring[] · min: 1 · max: 200Optionnel

The emails of members to invite

withEmailNotificationbooleanOptionnel

Set to true to send notification mail to each invited members

Default: false
Réponses
201
Spot members has been successfully invited
application/json
400
Malformed payload
413
Payload is too large
post
POST /v1/spotMembers~bulkInvite HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 49

{
  "emails": [
    "text"
  ],
  "withEmailNotification": false
}
{
  "created": [
    {
      "id": "text",
      "spotId": "text",
      "userId": "text",
      "email": "text",
      "title": "text",
      "role": "Member",
      "customRoleId": "text",
      "status": "Accepted",
      "firstname": "text",
      "lastname": "text",
      "warnings": 1,
      "embedBaseUrls": {
        "default": "text",
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "failed": [
    {
      "email": "text",
      "firstname": "text",
      "lastname": "text",
      "title": "text",
      "role": "Member",
      "avatarUrl": "text",
      "lang": "en",
      "theme": "light",
      "timezone": "Africa/Abidjan"
    }
  ]
}
put

Update a spot member

Paramètres de chemin
spotMemberIdstringRequis

The id of the spotMember

Corps
firstnamestringOptionnel

The first name of the spot member

lastnamestringOptionnel

The last name of the spot member

titlestringOptionnel

The title of the spot member

rolestring · enumOptionnel

The role of the spot member

Valeurs possibles:
statusstring · enumOptionnel

The status of the spot member

Valeurs possibles:
avatarUrlobject | nullableOptionnel
customRoleIdstring | nullableOptionnel

The custom role ID of spot member

Réponses
200
Spot member successfully updated
application/json
400
Malformed payload
404
Spot member not found
put
PUT /v1/spotMembers/{spotMemberId} HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 194

{
  "firstname": "text",
  "lastname": "text",
  "title": "text",
  "role": "Member",
  "status": "Accepted",
  "avatarUrl": {},
  "embedBaseUrls": {
    "default": "text",
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "customRoleId": "text"
}
{
  "id": "text",
  "spotId": "text",
  "userId": "text",
  "email": "text",
  "title": "text",
  "role": "Member",
  "customRoleId": "text",
  "status": "Accepted",
  "firstname": "text",
  "lastname": "text",
  "warnings": 1,
  "embedBaseUrls": {
    "default": "text",
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}