# Letterdrop Integration via LowCodeAPI

## Overview

Letterdrop is a content marketing platform that helps teams create, manage, and distribute content with AI-powered writing assistance and LinkedIn social selling features.

## Base Endpoint

```
https://api.lowcodeapi.com/letterdrop/
```

## Authentication

LowCodeAPI handles authentication automatically. You only need to:

1. **Sign up** at https://letterdrop.com/
2. **Connect your account** in LowCodeAPI dashboard
3. **Use your `api_token`** in all requests

The `api_token` is your LowCodeAPI authentication token. LowCodeAPI will automatically:
- Fetch your Letterdrop API key from database
- Apply it to each request with proper Bearer token header

**Auth Type**: `API Key` (Bearer Token)

## API Categories

- Content Management
- Letterdrop API
- LinkedIn Social Selling

## Common Endpoints

### Category: Letterdrop API

#### List posts

**Method**: `POST` | **LowCodeAPI Path**: `/v1/posts`

**Full URL**:
```
https://api.lowcodeapi.com/letterdrop/v1/posts?api_token={api_token}
```

**Description**: Get a summary of all your posts to be displayed on your home page.

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Request Body Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Search for posts containing these words |
| `offset` | number | No | Index of first post to return |
| `limit` | number | No | Number of posts to return |

**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/posts?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "marketing",
    "limit": 10
  }'
```

**Official Documentation**: https://docs.letterdrop.com/api#list-posts

---

#### Get post

**Method**: `POST` | **LowCodeAPI Path**: `/v1/post/get/id`

**Full URL**:
```
https://api.lowcodeapi.com/letterdrop/v1/post/get/id?id={id}&api_token={api_token}
```

**Description**: Get a single post with full details.

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the post |
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Example Request**:
```bash
# Post ID from list posts response
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/post/get/id?id=POST_ID&api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
```

**Official Documentation**: https://docs.letterdrop.com/api#get-post

---

#### Draft post

**Method**: `POST` | **LowCodeAPI Path**: `/v1/post/draft`

**Full URL**:
```
https://api.lowcodeapi.com/letterdrop/v1/post/draft?api_token={api_token}
```

**Description**: Create a new draft post with title, content, and subtitle.

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Request Body Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Title of your post |
| `html` | string | No | Body of your post in HTML format |
| `subtitle` | string | No | Subtitle of your post |

**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/post/draft?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "5 Content Marketing Trends for 2024",
    "subtitle": "Stay ahead with these emerging strategies",
    "html": "<p>Your content goes here...</p>"
  }'
```

**Official Documentation**: https://docs.letterdrop.com/api#draft-post

---

### Category: Projects

#### Get project

**Method**: `POST` | **LowCodeAPI Path**: `/v1/project/get/id`

**Full URL**:
```
https://api.lowcodeapi.com/letterdrop/v1/project/get/id?id={id}&api_token={api_token}
```

**Description**: Get project details including associated posts and settings.

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the project |
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Example Request**:
```bash
# Project ID from your Letterdrop workspace
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/project/get/id?id=PROJECT_ID&api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
```

**Official Documentation**: https://docs.letterdrop.com/api#get-project

---

### Category: Ideas

#### Create idea

**Method**: `POST` | **LowCodeAPI Path**: `/v1/idea/new`

**Full URL**:
```
https://api.lowcodeapi.com/letterdrop/v1/idea/new?api_token={api_token}
```

**Description**: Create a new content idea with title, description, and labels.

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Request Body Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Idea title |
| `suggestedBy` | string | Yes | Email address of the person who suggested the idea |
| `description` | string | No | Description with content brief |
| `keyword` | string | No | Keyword associated with the idea |
| `labels` | array | No | List of labels for categorization |

**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/idea/new?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Video Marketing Guide",
    "suggestedBy": "[email protected]",
    "description": "Comprehensive guide on B2B video marketing strategies",
    "keyword": "video marketing",
    "labels": ["guide", "B2B", "video"]
  }'
```

**Official Documentation**: https://docs.letterdrop.com/api#create-idea

---

#### Assign idea

**Method**: `POST` | **LowCodeAPI Path**: `/v1/idea/assign`

**Full URL**:
```
https://api.lowcodeapi.com/letterdrop/v1/idea/assign?api_token={api_token}
```

**Description**: Create a project from an idea and assign it to a writer.

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Request Body Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Idea ID to convert to project |
| `publishOn` | string | Yes | Target publish date |
| `assignedTo` | string | No | Email of the user writing the content |
| `approvers` | array | No | List of emails for approval workflow |

**Example Request**:
```bash
# Convert idea to project and assign
# id comes from Create idea response
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/idea/assign?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "IDEA_ID",
    "publishOn": "2024-02-15",
    "assignedTo": "[email protected]",
    "approvers": ["[email protected]"]
  }'
```

**Official Documentation**: https://docs.letterdrop.com/api#assign-idea

---

### Category: LinkedIn Social Selling

#### Like a post or comment on LinkedIn

**Method**: `POST` | **LowCodeAPI Path**: `/v1/social-selling/like`

**Full URL**:
```
https://api.lowcodeapi.com/letterdrop/v1/social-selling/like?api_token={api_token}
```

**Description**: Automatically like LinkedIn posts or comments from connected accounts.

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Request Body Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | URL of LinkedIn post or comment |
| `groups` | array | No | Names of groups to like from |
| `reactionType` | string | No | One of: 'like', 'celebrate', 'support', 'love', 'insightful', 'funny' |

**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/social-selling/like?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.linkedin.com/posts/user-post-id",
    "groups": ["sales", "execs"],
    "reactionType": "celebrate"
  }'
```

**Official Documentation**: https://docs.letterdrop.com/social-selling/linkedin-social-selling#like-a-post-or-comment-on-linkedin

---

#### Request a comment on a post or comment on LinkedIn

**Method**: `POST` | **LowCodeAPI Path**: `/v1/social-selling/request-comment`

**Full URL**:
```
https://api.lowcodeapi.com/letterdrop/v1/social-selling/request-comment?api_token={api_token}
```

**Description**: Automatically request comments on LinkedIn posts from connected accounts.

**Query Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `api_token` | string | Yes | Your LowCodeAPI authentication token |

**Request Body Parameters**:

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | URL of LinkedIn post or comment |
| `groups` | array | No | Group names to request comments from (e.g., ['sales', 'execs']) |

**Example Request**:
```bash
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/social-selling/request-comment?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.linkedin.com/posts/COMPANY/post-id",
    "groups": ["sales"]
  }'
```

**Official Documentation**: https://docs.letterdrop.com/social-selling/linkedin-social-selling#request-a-comment-on-a-post-or-comment-on-linkedin

---

## Usage Examples

### Example 1: Content Creation Workflow

Create and manage content ideas and posts.

```bash
# Step 1: Create a new content idea
# Returns idea ID for assignment
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/idea/new?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "AI in Marketing 2024",
    "suggestedBy": "[email protected]",
    "description": "Explore how AI is transforming content marketing",
    "labels": ["AI", "marketing", "technology"]
  }'

# Step 2: Assign idea to create a project
# Use the idea ID returned from step 1
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/idea/assign?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "IDEA_ID",
    "publishOn": "2024-03-01",
    "assignedTo": "[email protected]",
    "approvers": ["[email protected]"]
  }'

# Step 3: Create a draft post
# Write the actual content
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/post/draft?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "AI in Marketing 2024: Complete Guide",
    "subtitle": "How artificial intelligence is revolutionizing content strategies",
    "html": "<h1>Introduction</h1><p>AI is changing everything...</p>"
  }'
```

### Example 2: Browse and Retrieve Content

Search through your content library.

```bash
# List posts with search query
# Returns list of posts with summaries
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/posts?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "email marketing",
    "limit": 20
  }'

# Get full post details
# Use the post ID from list response
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/post/get/id?id=POST_ID&api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

# Get project information
# See associated posts and project settings
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/project/get/id?id=PROJECT_ID&api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
```

### Example 3: LinkedIn Social Selling

Boost engagement on LinkedIn posts automatically.

```bash
# Like a LinkedIn post from multiple groups
# Useful for amplifying company announcements
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/social-selling/like?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.linkedin.com/posts/yourcompany/new-product",
    "groups": ["all"],
    "reactionType": "celebrate"
  }'

# Request comments from your sales team
# Increases engagement on important posts
curl -X POST "https://api.lowcodeapi.com/letterdrop/v1/social-selling/request-comment?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.linkedin.com/posts/yourcompany/industry-insights",
    "groups": ["sales", "executives"]
  }'
```

## Complete Endpoint Reference

For a complete list of all endpoints and their parameters, refer to:
- **OpenAPI Definition**: `https://backend.lowcodeapi.com/letterdrop/definition`
- **Official Provider Documentation**: https://docs.letterdrop.com/api

## Rate Limits & Best Practices

- Use specific search queries to filter content efficiently
- Assign ideas with clear due dates for better workflow
- Use labels to organize content for easy retrieval
- Space out social selling actions to avoid platform restrictions

## Error Handling

Standard HTTP status codes apply. Errors include details about invalid IDs, missing required fields, or permission issues.