# Goodbits

Goodbits is a service that helps you and your business create stellar newsletters from the best links your team and customers are reading.

- **Category:** email newsletters
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `GOODBITS`
- **Version:** 20260211_00

## Tools

### Create Link

**Slug:** `GOODBITS_CREATE_LINK`

Tool to create a content link in Goodbits Content Library. Use when you have an article URL and optional metadata ready.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The URL of the article to save |
| `title` | string | No | Optional custom title for the link |
| `description` | string | No | Optional HTML description of the article |
| `image_candidates` | array | No | Optional list of candidate thumbnail image URLs |
| `fetch_remote_thumbnail_url` | string | No | Optional image URL to fetch as thumbnail |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Subscriber

**Slug:** `GOODBITS_CREATE_SUBSCRIBER`

Tool to add a new subscriber to the newsletter. Use after confirming user opt-in.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subscriber` | object | Yes | Subscriber object containing email and optional name details |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Subscriber

**Slug:** `GOODBITS_DELETE_SUBSCRIBER`

Tool to mark a subscriber as deleted. Use when you need to prevent future emails being sent to a subscriber.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Subscriber's email address to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Newsletter Info

**Slug:** `GOODBITS_GET_NEWSLETTER`

Tool to fetch newsletter identifier and name. Use after authenticating with your API token.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Subscriber Status

**Slug:** `GOODBITS_UPDATE_SUBSCRIBER_STATUS`

Tool to update subscriber status. Use when you need to change an existing subscriber’s subscription status by email. Example: "Update the status of john@example.com to unsubscribed"

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email of the subscriber to update |
| `status` | string ("unsubscribed" | "cleaned" | "pending" | "deleted") | Yes | New status for the subscriber |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |