Nextdoor API

POST https://cotlet.dev/api/v1/nextdoor/get_business_page

Returns the page the signed-in account manages. Use the neighborhoods it lists as the audience for create_post. The call fails if the account has no claimed Business Page.

Parameters

No parameters.

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/get_business_page \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("nextdoor", "get_business_page")

const result = await cotlet.call('nextdoor', 'get_business_page');

cotlet call nextdoor get_business_page

Example response

{
  "page_id": "pg_2204",
  "name": "Clearwater Gutter Care",
  "category": "Gutter cleaning",
  "phone": "+1 555 0142",
  "neighborhoods": [
    "Maple Hill",
    "Oak Park",
    "Riverside"
  ],
  "recommendations": 41,
  "faves": 118
}

POST https://cotlet.dev/api/v1/nextdoor/list_posts

Returns each post with title, text, audience, reactions and comment count. Nextdoor's Post Insights are not available for business posts, so there are no view counts. Use the cursor to read older posts.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/list_posts \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("nextdoor", "list_posts")

const result = await cotlet.call('nextdoor', 'list_posts');

cotlet call nextdoor list_posts

Example response

{
  "posts": [
    {
      "post_id": "bp_8812046",
      "title": "Open house this Saturday",
      "reactions": 12,
      "comments": 3,
      "created_at": "2026-10-08T09:30:00Z"
    },
    {
      "post_id": "bp_8790311",
      "title": "Fall gutter checks",
      "reactions": 7,
      "comments": 1,
      "created_at": "2026-10-01T08:00:00Z"
    }
  ],
  "next_cursor": null
}

POST https://cotlet.dev/api/v1/nextdoor/get_post

Returns the full text and the audience (distance or neighborhoods) the post was published to. Comments are read with list_comments.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/get_post \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"post_8c41d2"}'

result = client.call("nextdoor", "get_post", {"post_id":"post_8c41d2"})

const result = await cotlet.call('nextdoor', 'get_post', {"post_id":"post_8c41d2"});

cotlet call nextdoor get_post --data '{"post_id":"post_8c41d2"}'

Example response

{
  "post_id": "bp_8812046",
  "title": "Open house this Saturday",
  "body": "Drop by 10:00 to 14:00 for free coffee and a look at the new workshop.",
  "neighborhoods": [
    "Maple Hill",
    "Oak Park"
  ],
  "reactions": 12,
  "comments": 3
}

POST https://cotlet.dev/api/v1/nextdoor/list_comments

Returns comments oldest first, so your agent reads the discussion in order. Each comment has the ID that reply_to_comment needs.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/list_comments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"post_8c41d2"}'

result = client.call("nextdoor", "list_comments", {"post_id":"post_8c41d2"})

const result = await cotlet.call('nextdoor', 'list_comments', {"post_id":"post_8c41d2"});

cotlet call nextdoor list_comments --data '{"post_id":"post_8c41d2"}'

Example response

{
  "comments": [
    {
      "comment_id": "cm_77120",
      "author": "Priya S.",
      "neighborhood": "Maple Hill",
      "body": "Do you service Maple Hill?",
      "replied": false
    }
  ]
}

POST https://cotlet.dev/api/v1/nextdoor/list_recommendations

Returns newest first. Each recommendation has the ID that reply_to_recommendation needs, and your existing reply if you wrote one.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/list_recommendations \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("nextdoor", "list_recommendations")

const result = await cotlet.call('nextdoor', 'list_recommendations');

cotlet call nextdoor list_recommendations

Example response

{
  "recommendations": [
    {
      "recommendation_id": "rec_30418",
      "author": "Dana K.",
      "neighborhood": "Oak Park",
      "body": "Cleaned our gutters in one morning and left the yard spotless.",
      "date": "2026-10-06",
      "reply": null
    }
  ]
}

POST https://cotlet.dev/api/v1/nextdoor/get_page_share_link

Returns the page link. A neighbor who opens it can recommend your business on the page; Nextdoor asks them to sign in or create a free account first.

Parameters

No parameters.

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/get_page_share_link \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("nextdoor", "get_page_share_link")

const result = await cotlet.call('nextdoor', 'get_page_share_link');

cotlet call nextdoor get_page_share_link

Example response

{
  "url": "https://nextdoor.com/pages/clearwater-gutter-care"
}

POST https://cotlet.dev/api/v1/nextdoor/list_conversations

Returns the most recent threads first. Neighbors start these conversations; a business cannot start one.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/list_conversations \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("nextdoor", "list_conversations")

const result = await cotlet.call('nextdoor', 'list_conversations');

cotlet call nextdoor list_conversations

Example response

{
  "conversations": [
    {
      "conversation_id": "conv_5530",
      "neighbor": "Priya S.",
      "last_message": "Can you come Thursday morning?",
      "last_from": "neighbor",
      "updated_at": "2026-10-10T16:12:00Z"
    }
  ]
}

POST https://cotlet.dev/api/v1/nextdoor/get_conversation

Returns the messages oldest first. Reading a thread does not send anything.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/get_conversation \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":"conversation_8c41d2"}'

result = client.call("nextdoor", "get_conversation", {"conversation_id":"conversation_8c41d2"})

const result = await cotlet.call('nextdoor', 'get_conversation', {"conversation_id":"conversation_8c41d2"});

cotlet call nextdoor get_conversation --data '{"conversation_id":"conversation_8c41d2"}'

Example response

{
  "conversation_id": "conv_5530",
  "neighbor": "Priya S.",
  "messages": [
    {
      "from": "neighbor",
      "body": "Hi, do you do gutter guards?",
      "sent_at": "2026-10-10T15:58:00Z"
    },
    {
      "from": "business",
      "body": "Yes, we do. What is the address?",
      "sent_at": "2026-10-10T16:05:00Z"
    },
    {
      "from": "neighbor",
      "body": "Can you come Thursday morning?",
      "sent_at": "2026-10-10T16:12:00Z"
    }
  ]
}

POST https://cotlet.dev/api/v1/nextdoor/create_post

Publishes a post with a title and a description. Nextdoor's help center says business posts have no fixed radius and reach neighbors through engagement and Faves; radius and neighborhoods apply only where the post form still offers audience settings. The call fails for accounts Nextdoor still asks to verify business documents. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/create_post \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Open house this Saturday","body":"Drop by 10:00 to 14:00 for free coffee and a look at the new workshop.","radius":3}'

result = client.call("nextdoor", "create_post", {"title":"Open house this Saturday","body":"Drop by 10:00 to 14:00 for free coffee and a look at the new workshop.","radius":3})

const result = await cotlet.call('nextdoor', 'create_post', {"title":"Open house this Saturday","body":"Drop by 10:00 to 14:00 for free coffee and a look at the new workshop.","radius":3});

cotlet call nextdoor create_post --data '{"title":"Open house this Saturday","body":"Drop by 10:00 to 14:00 for free coffee and a look at the new workshop.","radius":3}'

Example response

{
  "post_id": "bp_8812046",
  "status": "published",
  "neighborhoods": 14,
  "url": "https://nextdoor.com/p/yourname-open-house"
}

POST https://cotlet.dev/api/v1/nextdoor/reply_to_comment

The reply is public and appears under your business name. Only the author or the page administrator can edit or delete it later. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/reply_to_comment \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"comment_id":"cm_77120","body":"Yes, we cover Maple Hill. Message the page with your street and we will suggest a time."}'

result = client.call("nextdoor", "reply_to_comment", {"comment_id":"cm_77120","body":"Yes, we cover Maple Hill. Message the page with your street and we will suggest a time."})

const result = await cotlet.call('nextdoor', 'reply_to_comment', {"comment_id":"cm_77120","body":"Yes, we cover Maple Hill. Message the page with your street and we will suggest a time."});

cotlet call nextdoor reply_to_comment --data '{"comment_id":"cm_77120","body":"Yes, we cover Maple Hill. Message the page with your street and we will suggest a time."}'

Example response

{
  "reply_id": "cm_77135",
  "comment_id": "cm_77120",
  "status": "published"
}

POST https://cotlet.dev/api/v1/nextdoor/reply_to_recommendation

The reply is public and appears under the recommendation as your business, not your personal profile. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/reply_to_recommendation \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recommendation_id":"rec_30418","body":"Thank you, Dana! Glad the gutters are running clear again."}'

result = client.call("nextdoor", "reply_to_recommendation", {"recommendation_id":"rec_30418","body":"Thank you, Dana! Glad the gutters are running clear again."})

const result = await cotlet.call('nextdoor', 'reply_to_recommendation', {"recommendation_id":"rec_30418","body":"Thank you, Dana! Glad the gutters are running clear again."});

cotlet call nextdoor reply_to_recommendation --data '{"recommendation_id":"rec_30418","body":"Thank you, Dana! Glad the gutters are running clear again."}'

Example response

{
  "reply_id": "rr_9120",
  "recommendation_id": "rec_30418",
  "status": "published"
}

POST https://cotlet.dev/api/v1/nextdoor/send_message

Works only in a conversation the neighbor started. A business cannot message a neighbor first, and Nextdoor bans unsolicited promotional messages. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/send_message \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":"conversation_8c41d2","body":"body"}'

result = client.call("nextdoor", "send_message", {"conversation_id":"conversation_8c41d2","body":"body"})

const result = await cotlet.call('nextdoor', 'send_message', {"conversation_id":"conversation_8c41d2","body":"body"});

cotlet call nextdoor send_message --data '{"conversation_id":"conversation_8c41d2","body":"body"}'

Example response

{
  "message_id": "msg_88410",
  "conversation_id": "conv_5530",
  "status": "sent"
}

POST https://cotlet.dev/api/v1/nextdoor/delete_post

Removes the post from the newsfeed. Only the author or the page administrator can delete a post. A deleted post cannot be restored with one call. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/nextdoor/delete_post \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"post_8c41d2"}'

result = client.call("nextdoor", "delete_post", {"post_id":"post_8c41d2"})

const result = await cotlet.call('nextdoor', 'delete_post', {"post_id":"post_8c41d2"});

cotlet call nextdoor delete_post --data '{"post_id":"post_8c41d2"}'

Example response

{
  "post_id": "bp_8790311",
  "status": "deleted"
}