W3lcome API
  • Introduction
  • FAQ
  • Authentication
  • Changelog
  • Host
    • The Host Object
    • Retrieve a Host
    • Retrieve a List of Hosts
    • Insert a Host
    • Update a Host
    • Delete a Host
  • Visit
    • The Visit Object
    • Retrieve a Visit
    • Retrieve a List of Visits
    • Change Visit Status
    • Check-out a Visit
    • Check-in with Invitee Id
    • Check-out with Invitee Id
    • Delete a Visit
  • Blocked list
    • The Blocked List Object
    • Retrieve a Person on the Blocked List
    • Retrieve a List of People from the Blocked List
    • Insert a Person on the Blocked List
    • Update a Person on the Blocked List
    • Delete a Person from the Blocked List
  • Invitee
    • The Invitee Object
    • Retrieve an Invitee
    • Retrieve a List of Invitees
    • Insert an Invitee
    • Update an Invitee
    • Delete an Invitee
  • Delivery
    • The Delivery Object
  • Meeting
    • The Meeting Object
  • Notification
    • The Notification Object
  • Webhook
    • Webhook Endpoints
  • Company
    • The Company Object
    • Retrieve Company Information
    • Company Fields
  • Integration
    • W-Access
    • SBT
    • SBT QRCodes
    • Workplace by Facebook
Powered by GitBook
On this page

Was this helpful?

  1. Host

Insert a Host

Push Host

POST https://api.w3lcome.com/v1/hosts

This endpoint allows you to add a host

Headers

Name
Type
Description

Content-Type

string

application/JSON

Authentication

string

Basic token

Request Body

Name
Type
Description

email

string

The email must be unique at each company

name

string

sendInvitationEmail

boolean

If true, W3lcome will send an email inviting the host to create an account at w3lcome.com. Default: false

role

string

One of employee, admin, frontDesk, manager, host

metadata

object

Optional object

isActive

boolean

additionalEmails

string

Emails separated by space

pictureUrl

string

position

string

sector

string

phone

string

countryCode

string

message

string

{
    "id": "5d13bad4ae9c50948f6edd67a16d6936",
    "email": "alisson@w3lcome.com",
    "name": "Alisson Enz Rossi",
    "isActive": true,
    "pictureUrl": "",
    "position": "CTO",
    "sector": "IT",
    "phone": "(43) 9 9982-0420",
    "countryCode": "+55",
    "isPhoneValid": true,
    "company": "W3lcome",
    "type": "host",
    "message": "",
    "role": "admin"
}
{
    "type": "ALREADY_EXISTS"
}

PreviousRetrieve a List of HostsNextUpdate a Host

Last updated 4 years ago

Was this helpful?