POST

https://{server-url}

/
instance
/
create

Authorizations

apikey
string
headerrequired

Your authorization key header

Body

application/json
instanceName
string
required

instance (Instance name)

token
string

apikey (Enter or leave empty to create dynamically)

number
string

559999999999 (Instance owner number with Country Code)

qrcode
boolean

Create QR Code automatically after creation

integration
enum<string>

WhatsApp engine

Available options:
WHATSAPP-BAILEYS,
WHATSAPP-BUSINESS
reject_call
boolean

Reject WhatsApp calls automatically

msgCall
string

Message to be sent when a call is rejected automatically

groupsIgnore
boolean

Ignore group messages

alwaysOnline
boolean

Keep WhatsApp always online

readMessages
boolean

Send read receipts to received messages

readStatus
boolean

Show sent messages read status

syncFullHistory
boolean

Whether to sync the full history of messages and chats or not

proxyHost
string

Proxy host

proxyPort
string

Proxy port

proxyProtocol
enum<string>

Proxy protocol

Available options:
http,
https
proxyUsername
string

Proxy username

proxyPassword
string

Proxy password

webhookUrl
string

Webhook URL

webhookByEvents
boolean

Enables the Webhook by events

webhookBase64
boolean

Sends media files on base64 via Webhook

webhookEvents
enum<string>[]

Events to be sent to the Webhook

Available options:
APPLICATION_STARTUP,
QRCODE_UPDATED,
MESSAGES_SET,
MESSAGES_UPSERT,
MESSAGES_UPDATE,
MESSAGES_DELETE,
SEND_MESSAGE,
CONTACTS_SET,
CONTACTS_UPSERT,
CONTACTS_UPDATE,
PRESENCE_UPDATE,
CHATS_SET,
CHATS_UPSERT,
CHATS_UPDATE,
CHATS_DELETE,
GROUPS_UPSERT,
GROUP_UPDATE,
GROUP_PARTICIPANTS_UPDATE,
CONNECTION_UPDATE,
LABELS_EDIT,
LABELS_ASSOCIATION,
CALL,
TYPEBOT_START,
TYPEBOT_CHANGE_STATUS
rabbitmqEnabled
boolean

Enables RabbitMQ

rabbitmqEvents
enum<string>[]

Events to be sent to the RabbitMQ

Available options:
APPLICATION_STARTUP,
QRCODE_UPDATED,
MESSAGES_SET,
MESSAGES_UPSERT,
MESSAGES_UPDATE,
MESSAGES_DELETE,
SEND_MESSAGE,
CONTACTS_SET,
CONTACTS_UPSERT,
CONTACTS_UPDATE,
PRESENCE_UPDATE,
CHATS_SET,
CHATS_UPSERT,
CHATS_UPDATE,
CHATS_DELETE,
GROUPS_UPSERT,
GROUP_UPDATE,
GROUP_PARTICIPANTS_UPDATE,
CONNECTION_UPDATE,
LABELS_EDIT,
LABELS_ASSOCIATION,
CALL,
TYPEBOT_START,
TYPEBOT_CHANGE_STATUS
sqsEnabled
boolean

Enable SQS

sqsEvents
enum<string>[]

Events to be sent to the SQS

Available options:
APPLICATION_STARTUP,
QRCODE_UPDATED,
MESSAGES_SET,
MESSAGES_UPSERT,
MESSAGES_UPDATE,
MESSAGES_DELETE,
SEND_MESSAGE,
CONTACTS_SET,
CONTACTS_UPSERT,
CONTACTS_UPDATE,
PRESENCE_UPDATE,
CHATS_SET,
CHATS_UPSERT,
CHATS_UPDATE,
CHATS_DELETE,
GROUPS_UPSERT,
GROUP_UPDATE,
GROUP_PARTICIPANTS_UPDATE,
CONNECTION_UPDATE,
LABELS_EDIT,
LABELS_ASSOCIATION,
CALL,
TYPEBOT_START,
TYPEBOT_CHANGE_STATUS
chatwootAccountId
integer

Chatwoot account ID

chatwootToken
string

Chatwoot authentication token

chatwootUrl
string

Chatwoot server URL

chatwootSignMsg
boolean

Send message signature on Chatwoot

chatwootReopenConversation
boolean

Reopen conversation on Chatwoot

chatwootConversationPending
boolean

Start the conversation as pending instead of open

chatwootImportContacts
boolean

Import contacts from WhatsApp to Chatwoot

chatwootNameInbox
string

Chatwoot inbox name (uses the instance name if empty)

chatwootMergeBrazilContacts
boolean

Whether to merge Brazilian number contacts with and without the additional 9. Ex: 553198765432 merges with 5531998765432

chatwootDaysLimitImportMessages
integer

Specifies how many days' messages to import from today

chatwootOrganization
string

Chatwoot organization name

chatwootLogo
string

Chatwoot logo URL

typebotUrl
string

Typebot server URL

typebot
string

Typebot flow name

typebotExpire
integer

Time to expire the session in seconds

typebotKeywordFinish
string

Keyword to finish the typebot flow (escape keyword)

typebotDelayMessage
integer

Default delay for the typebot messages

typebotUnknownMessage
string

TODO

typebotListeningFromMe
boolean

Typebot listen messages sent by the connected number

Response

201 - application/json
instance
object
hash
object
settings
object