> ## Documentation Index
> Fetch the complete documentation index at: https://help.suggix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# New Posts Trigger

> Retrieve recently created Suggix feedback posts for a Zapier trigger.

## `GET /triggers/new-posts`

Returns recent feedback posts in the API key's workspace, newest first. The endpoint only checks posts created in the last 30 days.

### Query parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `board_id` | integer | No | Only return posts from this board. Must be a positive integer. |
| `limit` | integer | No | Maximum number of results, from 1 to 100. Defaults to 100 when omitted or invalid. |

### Request

```http theme={null}
GET https://www.suggix.com/v1/triggers/new-posts?board_id=10&limit=10
Authorization: Bearer sgx_api_your_key
```

### Successful response

`200 OK` returns an array of post objects. An empty array means no matching posts were found in the lookback period.

```json theme={null}
[
  {
    "id": 367,
    "workspace_id": 7,
    "board_id": 10,
    "board_name": "Feature Request",
    "board_url": "feature-request",
    "creator_id": 14,
    "creator_name": "Alex",
    "creator_email": "alex@example.com",
    "creator_photo_url": "https://example.com/avatar.png",
    "creator_is_admin": false,
    "title": "Add keyboard shortcuts",
    "url": "add-keyboard-shortcuts",
    "text": "{\"time\":1791609328716,\"blocks\":[...],\"version\":\"2.31.6\"}",
    "html": "<div class=\"ce-block\">...</div>",
    "preview": "Add keyboard shortcuts",
    "is_pinned": false,
    "is_spam": false,
    "comments": 2,
    "votes": 8,
    "views": 31,
    "total_mrr": 0,
    "total_arr": 0,
    "owner_id": null,
    "due_date": null,
    "status_id": 7,
    "status_name": "Backlog",
    "status_type": 1,
    "priority": 2,
    "tags": [],
    "voted": false,
    "created_at": 1791609328722,
    "updated_at": 1791609328722
  }
]
```

### Response fields

| Field | Type | Description |
| - | - | - |
| `id`, `workspace_id`, `board_id`, `creator_id` | integer | Record and workspace identifiers. |
| `board_name`, `board_url` | string | Board display name and URL slug. |
| `creator_name`, `creator_email`, `creator_photo_url` | string | Creator details; optional values may be omitted. |
| `creator_is_admin` | boolean | Whether the creator is a workspace administrator; may be omitted when false. |
| `title`, `url` | string | Post title and URL slug. |
| `text` | string | Serialized Editor.js document JSON. |
| `html`, `preview` | string | Rendered post content and plain-text preview; may be omitted when empty. |
| `is_pinned`, `is_spam` | boolean | Post flags. |
| `comments`, `votes`, `views` | integer | Comment, vote, and view counts. |
| `total_mrr`, `total_arr` | number | Revenue totals; omitted when zero. |
| `owner_id`, `due_date`, `status_id` | integer or `null` | Optional owner, due date, and status identifiers. `due_date` is a Unix timestamp in milliseconds. |
| `status_name` | string or `null` | Status display name. |
| `status_type` | integer or `null` | Status category: `1` Backlog, `2` Planned, `3` In Progress, `4` Completed, `5` Canceled. |
| `priority` | integer or `null` | Priority: `1` Low, `2` Medium, `3` High, `4` Urgent. |
| `tags` | array | Post tags; each tag is an object. |
| `voted` | boolean | Whether the API key owner has voted for this post. |
| `created_at`, `updated_at` | integer | Unix timestamps in milliseconds. |
| `deleted_at` | integer | Deletion timestamp in milliseconds; omitted when not deleted. |

### Errors

| HTTP status | Response | Cause |
| - | - | - |
| `400` | `{"error":"invalid board_id"}` | `board_id` is not a positive integer. |
| `401` | `{"error":"invalid or missing API key"}` | The API key is absent or invalid. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.