# Listing Push Notification

Listing-related push notifications notify users when important **listing activities** occur in your Sharetribe marketplace.

These notifications help keep users engaged and informed about changes without requiring them to open the app.

### What Are Listing Push Notifications?

Listing push notifications are sent when events related to listings occur, such as:

* Listing created
* Listing updated
* Listing published
* Listing deleted

Each event triggers a **one-time push notification** to the relevant user’s mobile device.

### 📌 Important Notes

* **Each push notification must be triggered from one Zap**
* You must create **two separate Zaps**:
  * **Zap 1:** Listing Events
  * **Zap 2:** Transaction Events
* Each Zap must send data to **Twinr’s Push Notification Webhook Endpoint**
* Both Zaps work independently and must be published separately

## Create Zap for Listing Events

Create this Zap **only if you want push notifications for listing-related events**.

### Step 1: Create a New Zap

1. Log in to **Zapier**
2. Click **Create Zap**

<figure><img src="/files/c59djpc1FPrnzKjKw2XC" alt=""><figcaption></figcaption></figure>

### Step 2: Select Sharetribe as Trigger App

1. Choose **Sharetribe**
2. Click **Continue**
3. Connect your Sharetribe account
4. Select the correct marketplace

<figure><img src="/files/qvaFOPM8aWNsDkQIrqTV" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/4CtmGH3zHlgSkFX7AgRX" alt=""><figcaption></figcaption></figure>

### Step 3: Choose Trigger Event (Listing Events)

1. Select **Listing Events**
2. Click **Continue**
3. Choose an **Event Type**, such as:
   * Listing created
   * Listing updated
   * Listing deleted
   * Listing published
4. Test the trigger and continue

<figure><img src="/files/9aRsYrDc3m1UajKUfHu4" alt=""><figcaption></figcaption></figure>

5. Select Account&#x20;
6. Enter Client ID and Client Secret (Available in Sharetribe Application)

<figure><img src="/files/uNbBYPF1eyxdKAsFSQ30" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/4prQKCyRR0WhBz5GMxDt" alt="" width="563"><figcaption></figcaption></figure>

### Step 4: (Optional) Format Date/Time

1. Click "Action" or "+"
2. Add **Formatter by Zapier**&#x20;

<figure><img src="/files/bvLDVqo255drM061orUJ" alt=""><figcaption></figcaption></figure>

1. Select **Date / Time**
2. Go to **Configure**
3. Format the timestamp if required
4. Continue

<figure><img src="/files/IUvzjdes7TLcSuD7PTmQ" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/ib27rVhGWUkKjtzCKe14" alt="" width="563"><figcaption></figcaption></figure>

### Step 5: Send Push Notification to Twinr

1. Add **Webhooks by Zapier**

<figure><img src="/files/ZgFSUPh1npZvaU2sOMT5" alt="" width="563"><figcaption></figcaption></figure>

2. Choose **any HTTP method**:

* POST
* GET
* PUT
* Custom Request

<figure><img src="/files/gSJNk1AXmYMmJ0tjOdQU" alt="" width="563"><figcaption></figcaption></figure>

3. Click "Continue"&#x20;
4. Click **Method** and Select **POST**&#x20;
5. Enter the **Twinr Push Notification Webhook Endpoint** in **URL** field

{% hint style="success" %}
[https://msengageapi.twinr.dev/v3/send-one-time-notifications](https://msengageapi-stage.twinr.dev/v3/send-one-time-notifications)
{% endhint %}

Each field in the request body controls how and where the push notification is delivered.

| Field               | Description                                                                                                                                                                                  |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `app_id`            | <p>Unique App ID of your Twinr application. This ensures the notification is sent to the correct app. (You will find App ID from  URL)<br><img src="/files/sHucSHgHI2qkYZOxYb2k" alt=""></p> |
| `push_title`        | Title text shown at the top of the push notification.                                                                                                                                        |
| `push_message`      | Main message content displayed in the notification.                                                                                                                                          |
| `push_image`        | Optional image URL to display in the notification (if supported by the platform).                                                                                                            |
| `is_android`        | Set to `true` to send the notification to Android devices.                                                                                                                                   |
| `is_ios`            | Set to `true` to send the notification to iOS devices.                                                                                                                                       |
| `segment_id`        | Target a specific user segment (optional).                                                                                                                                                   |
| `click_action.type` | Defines what happens when the user taps the notification (for example, open a screen or deep link).                                                                                          |

6. Map required fields (listing data + `app_id`)&#x20;

OR

6. Enter API Request body in the **Data** field if you choose "Custom Request"
7. Make **Data Pass -Through?** - **False**
8. Click **Continue**
9. Test the request

### Step 6: Publish Zap

* Click **Publish**
* Your Listing Events push notification is now live


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.twinr.dev/plugins/sharetribe/listing-push-notification.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.