Setting Up an Integration for the Marketplace

Knowledge Base

Knowledge Base

Setting Up an Integration for the Marketplace

The Marketplace is a catalog of CRMs that can be integrated with Wazzup. It is located in the "Integration with CRM" section of your Wazzup account and appears when no integration has been connected yet.

This article explains how to create, submit for moderation, and update your integration in the marketplace.

To use the methods described above, use Basic authentication with your Wazzup partner account login credentials:

Authorization: Basic base64(email:password)

List of Methods

POST /v2/marketplaces — create an integration in the marketplace
PATCH /v2/marketplaces — update an integration in the marketplace

Set Up an Integration

Method POST /v2/marketplaces

Request Parameters

Parameter. Required are marked with *	Type	Description
`crm_code*`	string	Internal CRM identifier. A string consisting of Latin letters, numbers, hyphens, and underscores. Must be unique within Wazzup
`auth_redirect_uri*`	string	The redirect URI registered with Wazzup. This is the address the client is redirected to in order to confirm authorization
`secret*`	string	A key (token) used to confirm the integration installation. Used exclusively in server-to-server requests and is never sent to the client

These parameters will be used when your client selects your CRM in the Wazzup marketplace and clicks Connect. The integration connection process is described at the end of this article.

Request Example

curl -X POST \
'https://tech.wazzup24.com/v2/marketplaces' \
-H 'Authorization: Basic base64(email:password)' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"crm_code": "YouCrmCode123",
"secret": "secret key",
"auth_redirect_uri": "https://example.com/redirect"
}'

Response Example

{
"data": null,
"meta": {
"timestamp": 1759492896
}
}

Result: The integration has been created. Now add a logo and name using the method below.

Update an Integration in the Marketplace

Method PATCH /v2/marketplaces

Request Parameters

Parameter. Required are marked with *	Type	Description
`crm_name*`	string	Public CRM name as displayed in the Wazzup account. May contain letters, numbers, and hyphens. Maximum length: 50 characters
`logo*`	object	Object containing the logo data. Requirements: transparent or white background, SVG format, no internal padding, company name in English within the logo
`logo.name*`	string	Logo file name
`logo.content*`	string	base64-encoded logo file

Request Example

curl -X PATCH \
'https://tech.wazzup24.com/v2/marketplaces' \
-H 'accept: application/json' \
-H 'Authorization: Basic base64(email:password)' \
-H 'Content-Type: application/json' \
-d '{
"crm_name": "The Cool CRM",
"logo": {
"name": "the-cool-crm.svg",
"content": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBxAQDQ0NDQ0NDQ8NDw..."
}
}'

Response Example

{
"data": null,
"meta": {
"timestamp": 1759492896
}
}

Result: The integration has been updated and submitted for moderation.

Connecting an Integration: A User's Guide

1. The user selects your CRM in the Wazzup integrations marketplace and clicks Connect.

2. The user is redirected to your CRM to confirm the integration connection.

At this step, Wazzup will append the following parameters to your redirect_uri: ?code=...&state=....

Extract the code value from the browser address bar — it appears after "code=" and ends before the "&state" delimiter. Exchange this code for user access tokens. These tokens allow you to send messages, receive webhooks, and make other API calls on behalf of the end customer.

For details, see Step 2: Exchange the received code for user access tokens in the OAuth guide.

3. Done — the user has successfully connected Wazzup to your CRM, and you've received the client access tokens.

Now your CRM can:

Fetch user data, deals, contacts, and funnels with their stages
Set up the webhook URL for receiving events