API keys for developers

Personal API keys: making one, what it can do and its limits.

37 answers · Search the help centre

What is a personal API key on Ur Next Door?

A personal API key lets an AI tool, an automation or a script act for you on Ur Next Door: create and schedule posts and other content, read the site, edit your own items, and, if you allow it, comment, follow, connect and message.

Every action follows the same rules as on the website and is credited to you.

Who can create an API key?

Any signed-in member can create one, on any plan including the free one. The free plan has lower daily limits than paid plans.

How do I create an API key?

Go to API keys in Settings and press "Create API key". Give it a name, tick what it may do, choose when it expires, and press "Create key".

Copy the key straight away and paste it into your tool. You also get an email whenever a key is created on your account.

I lost my API key. Can I see it again?

No. A key is shown only once, when you create it, and Ur Next Door keeps only a one-way fingerprint of it. Revoke the lost key in API keys and create a new one.

How many API keys can I have?

Up to 5 active keys at a time. Revoked and expired keys do not count; revoke one you no longer use to create another.

How long does an API key last?

You choose when you create it: 30 days, 90 days (the default), 365 days, or never.

What happens when my API key expires?

It stops working at once, and calls with it are refused as an invalid key. It stays in your list in API keys, marked Expired. Create a new key to carry on.

Keys also stop working while an account is suspended.

What permissions can an API key have?

There are twelve: Create content, Upload images, Manage scheduled, Edit your content, Read lookups, Read the site, Comment and react, Follow and connect, Notifications, Profile and settings, Messages, and Marketplace and jobs.

You tick them when you create the key, and the key can do only what you ticked.

Why are some API key permissions unticked by default?

Comment and react, Follow and connect, Notifications, Profile and settings, Messages, and Marketplace and jobs start unticked because they act toward other members or your account. Tick them only if your tool needs them.

Can I change what an existing API key may do?

No. A key keeps the permissions it was made with. Create a new key with the permissions you need, then revoke the old one.

Keys made before 16 October 2026 have only the four original permissions, so make a new key for the newer ones.

How do I revoke an API key?

Open API keys, find the key and press Revoke. It stops working on the next call.

Resetting your password also revokes all your keys at once.

What can I do through the Ur Next Door API?

Create and schedule posts, questions, polls, MCQs, communities, services and jobs; read feeds, search, profiles, communities, services and jobs; edit, archive and unarchive your own items; comment, answer, react, save and vote; follow and connect; read notifications; update your profile and CV; and book services and apply to jobs. While chat is switched on, it can also message your connections.

Each needs the matching permission on the key.

What can't an API key do?

A key can never delete anything (it can only cancel a scheduled item), sign in or out, change your password or email, delete your account, or manage API keys. It also cannot take payments or mark a booking paid, change community roles, remove members or connections, or use the admin panel.

Can I delete my posts through the API?

No. The API never deletes anything. It can cancel a scheduled item, or archive your own item so it leaves public listings; deleting stays on the website.

As a community moderator, can I edit other members' posts with an API key?

No. Through a key you can edit only your own items, even if you are a moderator; the call is refused as not your content. Moderators keep their powers on the website. A community admin can still edit the community's settings through a key.

Can my API key send messages to anyone?

No. Messages need the Messages permission and work only while chat is switched on. A new direct chat, or a new group member, must be one of your accepted connections.

How do the API's daily limits work?

Each action, such as posts, comments or follows, has its own daily limit for all your keys together, and it resets at midnight UTC (5:30 am in India). A call that fails does not count. Reading and most status changes have no daily limit.

API keys shows today's usage against each limit.

Is there a per-minute limit on API calls?

Yes. You can make up to 60 calls a minute across all your keys, and actions that reach other members, such as comments, follows and messages, have tighter per-minute limits.

What do the "missing_api_key" and "invalid_api_key" errors mean?

"missing_api_key" means the call was sent without a key: send it as "Authorization: Bearer und_sk_..." or in an "X-API-Key" header. "invalid_api_key" means the key is mistyped, revoked or expired, or the account is not active.

What does the "insufficient_scope" error mean?

Your key does not have the permission that action needs, for example Comment and react for posting a comment. Create a new key with that permission ticked.

What does the "wrong_host" error mean?

You called the API on a community's own address. Always call it on https://urnextdoor.com, not on a community subdomain.

What do "quota_exceeded" and "rate_limited" mean?

"quota_exceeded" means you used today's limit for that action; it resets at midnight UTC. "rate_limited" means too many calls in a minute, or too many wrong keys sent from one address. Both answers say how long to wait.

Where can I see how much of my API limit I have used?

API keys shows today's usage for each action and when it resets, plus your latest API calls with their result.

Can I see what my API keys did on my behalf?

Yes. Analytics in Settings shows everything you did, split by website, app and API, with a breakdown by API key, the full event log and a CSV download.

How long are my API call records kept?

The log of calls made with your keys is kept for 30 days, and your activity record for about 13 months (400 days). A revoked key stays listed for 90 days. All of these are deleted with your account.

Does Ur Next Door store my API key?

No. It keeps only a one-way fingerprint of the key, plus its first and last characters so you can recognise it in the list.

Which AI tools can I use with my API key?

Claude Code, Codex, a ChatGPT custom GPT, Postman, n8n, Zapier or any script. A ChatGPT GPT can hold only 30 actions, so ChatGPT gets two ready-made sets, Create and Social, one GPT each.

Can I use the API from Claude Desktop or claude.ai?

Not yet. They need a connector that is not available yet. Claude Code, Codex, ChatGPT custom GPTs, Postman and scripts work today.

Where can I read how to use the API?

Step-by-step guides, a prompt for AI agents and the full API description are at docs.urnextdoor.com. API keys links to the guides for Claude Code, ChatGPT, Codex and Postman.

How do I send my API key with a call?

Send it in a header on every call: "Authorization: Bearer und_sk_..." or "X-API-Key: und_sk_...". Never put it in the address, and keep it in an environment variable, not in a web page or a shared chat.

Can I schedule posts through the API?

Yes. Posts, questions, polls, MCQs, services and jobs can be created for a later time, and a community can be scheduled too. You can list, reschedule, publish early or cancel scheduled items, and they also show on your Scheduled page.

Is it safe if my tool repeats the same API call?

Yes, for likes, follows and saves: repeating one answers "nothing changed" and sends no second notification. For creates, send an Idempotency-Key header, and a repeat within 24 hours returns the first result instead of creating it twice.

Can I get unlimited API use?

The Ur Next Door team can give a chosen member unlimited API use from the admin panel; members cannot ask for it in the product. It removes the daily limits but keeps a ceiling of 600 calls a minute, and does not change your plan or permissions.

Can I send Markdown through the API?

No. Bodies must be HTML; Markdown is not accepted.

Does the website's daily posting limit apply to API keys?

No. The limit of 20 posts, questions, polls and MCQs a day, together, on the website and the app does not apply to keys; keys have their own daily limits instead. The duplicate-title rule does apply: a key cannot post a title you already used on the same kind of item (post, question, poll or MCQ) in the last 30 days.

Can I use the AI writing assistant through the API?

No. The AI writing assistant is not part of the API. Your own AI tool writes the text and sends it through your key.