# wp_create_comment

![comment](https://img.shields.io/badge/category-comment-lightgrey)

Creates a new comment on a post.

## Parameters

| Parameter      | Type     | Required | Description                       | Default | Examples                                              |
| -------------- | -------- | -------- | --------------------------------- | ------- | ----------------------------------------------------- |
| `post`         | `number` | ✅       | The ID of the post to comment on. | -       | `example`                                             |
| `content`      | `string` | ✅       | The content of the comment.       | -       | `<p>Post content here</p>`, `This is my post content` |
| `author_name`  | `string` | ❌       | The name of the comment author.   | -       | `example`                                             |
| `author_email` | `string` | ❌       | The email of the comment author.  | -       | `example`                                             |

## Examples

### Basic comment Usage

Simple example of using wp_create_comment

**Command:**

```bash
wp_create_comment --post="example_value" --content="This is example content for the post."
```

**Response:**

```json
{
  "success": true,
  "data": {
    "id": 123,
    "title": "Created/Updated successfully",
    "status": "publish"
  }
}
```

**Error Example (Authentication failure):**

```json
{
  "error": "Authentication failed",
  "message": "Invalid credentials or insufficient permissions"
}
```

### Advanced comment Configuration

Comprehensive example using all available parameters

**Command:**

```bash
wp_create_comment --post="example_value" --content="This is example content for the post." --author_name="example_value" --author_email="example_value"
```

**Response:**

```json
{
  "success": true,
  "data": {
    "id": 123,
    "title": "Created/Updated successfully",
    "status": "publish"
  }
}
```

## Response Format

**Return Type:** `comment`

```json
{
  "success": true,
  "data": {
    // comment response data
  },
  "metadata": {
    "timestamp": "2024-01-01T00:00:00.000Z",
    "tool": "wp_create_comment",
    "site": "site1"
  }
}
```

## Error Handling

### AUTHENTICATION_FAILED

**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
Check your authentication credentials and user permissions

### VALIDATION_ERROR

**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
**Resolution:** Review the required parameters and their formats

### NOT_FOUND

**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
resource ID and ensure it exists

### PERMISSION_DENIED

**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
**Resolution:** Contact an administrator to grant the necessary permissions

---

_Generated automatically from tool definitions - Do not edit manually_
