---
title: Connect your Custom App with SyncMate
description: "To connect your **Custom App** with **SyncMate**, you need to follow the easy steps below: **Step 1**First of all, you will need to connect your **WhatsApp with SyncMate**, If you haven't done this yet, please follow our **[Configuration guide](https://assistro.co/user-guide/syncmate/how-to-connect-your-whatsapp-with-syncmate/).** **Step…"
url: "https://www.assistro.co/user-guide/developer-guide/connect-your-custom-app-with-syncmate/"
updated: "2026-07-14"
category: Developer Guide
---

# Connect your Custom App with SyncMate

To connect your **Custom App** with **SyncMate**, you need to follow the easy steps below:

**Step 1**First of all, you will need to connect your **WhatsApp with SyncMate**, If you haven't done this yet, please follow our **[Configuration guide](https://assistro.co/user-guide/syncmate/how-to-connect-your-whatsapp-with-syncmate/).**

**Step 2**

Go to App module

![](https://assistro.co/wp-content/uploads/2026/03/connect-n8n-1.jpg)

Scroll TO API App Click on Manage App

![](https://assistro.co/wp-content/uploads/2026/02/api-step-1.jpg)

Select API & Token

![](https://assistro.co/wp-content/uploads/2026/02/api-step-2.jpg)

Copy the API TOKEN by click on this

![](https://assistro.co/wp-content/uploads/2026/02/appi-step-3.jpg)

 

## **TL;DR:** Need more examples? [Checkout our Postman Collection](https://www.postman.com/syncmate/syncmate-by-assistro-api-specifications/collection/52527883-c485760a-2f03-4afc-9436-27a2952f3752?action=share&source=copy-link&creator=52527883) to test these endpoints directly in your environment.

**Step 3: Making API Requests**You can send messages using either our Single Messaging or Bulk Messaging endpoints. All API requests require your API Key to be passed as a Bearer token in the authorization header.

**Required Headers:**The parameters that are required to make a post request on the above URL:

```
headers = {
	     "Authorization": "Bearer {bearer_token}",
	     "Content-Type": "application/json"
	  }
```

#### 1. Single Messaging Endpoint

**POST** `https://app.assistro.co/api/v1/wapushplus/single/message`

Use this endpoint to send a message to a single contact.

**Request Body:**

```
Request body = {
    "msgs": [
        {
            "number": 911234567890, //Whatsapp number with country code
            "message": "Hi! How are you?",
            "media": [
                {
                    "media_base64": "BASE64_STRING (without mime_type in the beginning)",
                    "file_name": "YOUR_FILENAME"
                }
            ]
        }
    ]
}
```

*Notes:* * `"number"`: Must be a string containing the WhatsApp number with the country code (no `+` sign).

- `"type"`: Use `1` for direct messages, `2` for groups, or `3` for newsletters/channels.
- `"media_base64"`: (Optional) Provide the raw base64 string *without* the MIME type prefix (e.g., do not include `data:image/png;base64,`).

#### 2. Bulk Messaging Endpoint

**POST** `https://app.assistro.co/api/v1/wapushplus/bulk/message`

Use this endpoint to send multiple messages in a single API call.

**Request Body:**

```
Request body =  {
    "msgs": [
        {
            "number": 911234567890, //Whatsapp number with country code
            "message": "Hi! How are you?",
            "media": [
                {
                    "media_base64": "BASE64_STRING (without mime_type in the beginning)",
                    "file_name": "YOUR_FILENAME"
                }
            ]
        },
        {
            "number": 911234567890, //Whatsapp number with country code
            "message": "Hey there!"
        },
        {
            "number": 911234567890, //Whatsapp number with country code
            "message": "Good Morning!"
        }
    ]
}
```

**Common Status Codes:**

- **200 OK:** Your request was successful and messages are queued for delivery.
- **400 Bad Request:** There is a formatting error in your request body (e.g., missing a required field like `"number"` or `"type"`).
- **401 Unauthorized:** Your API key is missing or invalid. Check your Bearer token.
- **500 Internal Server Error:** An unexpected error occurred on our end.