# Udemy API and MCP server

> Udemy has an Instructor API that lists your courses, reads reviews, and reads and answers Q&A questions and direct messages (checked 12 Oct 2026). It has no coupons, announcements, review responses, course edits or revenue.

Online course marketplace where instructors publish video courses and earn a share of each sale.

## What is the Udemy API?

Cotlet's Udemy API exposes 11 endpoints for your own Udemy account: list courses, get course performance, get revenue report, list coupons, list reviews, list Q&A questions, create coupon, update course landing page, send announcement, reply to Q&A question and respond to review. The list_courses endpoint returns courses you teach, with status, price, students, rating and URL. Each endpoint takes simple JSON inputs like course_id, since or body and works both as an MCP tool for agents and as a REST call for scripts.

- **Category:** [Courses & training](https://cotlet.dev/integrations/category/courses-training)
- **Endpoints:** 11 (6 read, 5 write)
- **Updated:** 2026-10-12

Udemy has an Instructor API that lists your courses, reads reviews, and reads and answers Q&A questions and direct messages (checked 12 Oct 2026). Cotlet is a hosted MCP server and REST API for Udemy with 11 endpoints (6 read, 5 write): your AI agent signs in as you and does the work.

## Does Udemy have an official API?

Udemy has an Instructor API that lists your courses, reads reviews, and reads and answers Q&A questions and direct messages (checked 12 Oct 2026). It has no coupons, announcements, review responses, course edits or revenue.

| Task | Udemy official | Cotlet |
|---|---|---|
| Create coupons | No | Yes |
| Send announcements and promotional emails | No | Yes |
| Monthly revenue report | No | Yes |
| Enrollments and ratings per course | No | Yes |
| Edit the course landing page | No | Yes |
| Respond to reviews | Partly: Reads reviews; no documented way to post a response | Yes |
| Answer Q&A questions | Yes: Instructor API posts Q&A replies with a bearer token | Yes |
| List your courses | Yes: Instructor API, bearer token | Yes |

Sources: [Udemy Instructor API v1.0 reference](https://www.udemy.com/developers/instructor/), [Udemy Help: coupons and referral links](https://support.udemy.com/hc/en-us/articles/229603968), [Udemy Help: announcements rules and guidelines](https://support.udemy.com/hc/articles/229605828-Announcements-Rules-and-Guidelines), [Udemy Help: promotional emails rules and guidelines](https://support.udemy.com/hc/articles/229605908-Promotional-Emails-Rules-and-Guidelines), [Udemy Help: Reviews dashboard](https://support.udemy.com/hc/en-us/articles/229606208-How-to-Manage-Student-Feedback-Using-the-Reviews-Dashboard)

## For AI agents

```text
Udemy has an Instructor API that lists your courses, reads reviews, and reads and answers Q&A questions and direct messages (checked 12 Oct 2026). It has no coupons, announcements, review responses, course edits or revenue.
Cotlet provides a hosted MCP server and REST API for Udemy: 11 tools (6 read, 5 write).
Access       Request access at https://cotlet.dev/app/signup?app=udemy; we email the API key.

MCP server   https://cotlet.dev/mcp/v1
REST base    https://cotlet.dev/api/v1/udemy
Auth         Authorization: Bearer <COTLET_API_KEY>. Listing endpoints and schemas needs no key; calling an endpoint needs one.
Tools        list_courses, get_course_performance, get_revenue_report, list_coupons, list_reviews, list_questions, create_coupon, update_course_landing_page, send_announcement, reply_to_question, respond_to_review
Confirm      create_coupon, update_course_landing_page, send_announcement, reply_to_question, respond_to_review (by default the user approves each call; the user can switch this off per tool, e.g. for scheduled automations)
Markdown     https://cotlet.dev/integrations/udemy-api-mcp-server.md

How access works:
1. The user requests access at https://cotlet.dev/app/signup?app=udemy (Udemy is pre-selected). Each request is reviewed and the API key is sent by email.
2. The user signs in to Udemy once in a browser. An agent cannot do this step.
3. The API key goes into the MCP client or the REST call as a bearer token.

Fits: people who want a hosted Udemy server that someone else maintains, including non-developers. Developers who prefer to run and fix code on their own computer can use an open-source Udemy MCP server instead.

Policy: Cotlet never stores passwords, never solves CAPTCHAs, never bypasses MFA.
Company: legal details in the Terms of service at https://cotlet.dev/terms. Contact contact@cotlet.dev.
Session: the user signs in to Udemy in a browser; Cotlet keeps only the session, AES-256 encrypted, revocable in the dashboard at any time.
Terms: the user stays responsible for following Udemy's terms; Cotlet is not affiliated with Udemy.
```

## What can an AI agent do in Udemy?

Cotlet is best for Udemy instructors who are not developers and want their AI agent to handle coupons, announcements, Q&A, reviews and revenue reports without running or fixing a server.

- **[Create Udemy coupons every month](https://cotlet.dev/integrations/udemy-api-mcp-server/create-udemy-coupons)** (runs: monthly): "On the 1st of each month, create a custom price coupon at $12.99 for each of my paid Udemy courses, starting 9:00 Pacific, and give me the links with expiry dates. Skip courses that still have an active coupon." → `list_courses`, `list_coupons`, `create_coupon`
- **Monthly Udemy revenue report** (runs: monthly): "How much did I earn on Udemy last month, and which course and channel brought the most?" → `get_revenue_report`
- **Answer Udemy Q&A questions** (runs: daily): "Draft answers to every unanswered Q&A question from this week in my Excel course and show them to me before posting." → `list_questions`, `reply_to_question`
- **[Respond to Udemy reviews](https://cotlet.dev/integrations/udemy-api-mcp-server/respond-to-udemy-reviews)** (runs: weekly): "Every Monday, draft responses to last week's Udemy reviews of 3 stars or less across all my courses. Answer the actual complaint, point to the lecture that covers it, and never ask for a better rating." → `list_courses`, `list_reviews`, `respond_to_review`
- **[Send Udemy announcements and promotional emails](https://cotlet.dev/integrations/udemy-api-mcp-server/send-udemy-announcements)**: "I just published a lecture on React Server Components. Send an educational announcement to students of my React course, and draft a promotional email to students of my JavaScript course offering the React course with this month's coupon." → `list_courses`, `list_coupons`, `send_announcement`

## Can Udemy automations run on a schedule in n8n, Make or Zapier?

Yes. Cotlet does not replace your automation platform: it gives it a Udemy connection it does not have, with the same API key as your agent. Write actions ask for your OK by default; switch that off in your dashboard for the tools you choose, for example to create udemy coupons every month, and the schedule runs on its own. Cotlet runs in the cloud, so it keeps going while your computer is off.

| Where | How to connect | How to schedule |
|---|---|---|
| Your AI agent | Add https://cotlet.dev/mcp/v1 with your API key. | A scheduled agent run, for example a Claude Code routine. |
| n8n | MCP Client node with https://cotlet.dev/mcp/v1, or an HTTP Request node to https://cotlet.dev/api/v1/udemy/{tool}. | Schedule Trigger node. |
| Make | HTTP module: POST https://cotlet.dev/api/v1/udemy/{tool} with an Authorization: Bearer header and a JSON body. | Scenario schedule. |
| Zapier | Webhooks by Zapier: POST https://cotlet.dev/api/v1/udemy/{tool} with the same header and body. | Schedule by Zapier trigger. |
| Your own script | POST https://cotlet.dev/api/v1/udemy/{tool} with your API key. | cron or GitHub Actions. |

## Tools

**For AI agents:** Every endpoint and its schema is public. The 11 endpoints on this page, with parameters and example responses, can be listed without an account. Calling one returns 403 until the account has an API key with access to Udemy.

### list_courses

Courses you teach, with status, price, students, rating and URL. Access: read. REST: `POST /api/v1/udemy/list_courses`.

| Parameter | Type | Required | Description |
|---|---|---|---|
| `status` | enum | no | published, draft or all. Default: all. |

Returns every course on your instructor account, published and draft. Use course_id from each item as the parameter of the other endpoints. Students and rating are the numbers Udemy shows for the course.

Example response:

```json
{
  "courses": [
    {
      "course_id": "4821736",
      "title": "Python for Beginners",
      "status": "published",
      "price": "$54.99",
      "students": 8421,
      "rating": 4.6,
      "url": "https://www.udemy.com/course/python-for-yourname/"
    },
    {
      "course_id": "5102298",
      "title": "Excel Pivot Tables",
      "status": "draft",
      "price": null,
      "students": 0,
      "rating": null,
      "url": null
    }
  ]
}
```

### get_course_performance

Revenue, enrollments and rating for one course over a period, from the Performance dashboard. Access: read. REST: `POST /api/v1/udemy/get_course_performance`.

| Parameter | Type | Required | Description |
|---|---|---|---|
| `course_id` | string | yes | Course ID from list_courses. |
| `period` | enum | no | 7d, 30d, 12m or all. Default: 30d. |

Returns the figures the Performance dashboard shows for one course: revenue, new enrollments and average rating for the period. Use it for a weekly or monthly check on a single course.

Example response:

```json
{
  "course_id": "4821736",
  "period": "30d",
  "revenue": {
    "amount": 1284.5,
    "currency": "USD"
  },
  "enrollments": 212,
  "rating": 4.6
}
```

### get_revenue_report

Monthly earnings with revenue by channel (Udemy Organic, Your Promotions, Udemy Business and more), by course, refunds and tax withheld. Access: read. REST: `POST /api/v1/udemy/get_revenue_report`.

| Parameter | Type | Required | Description |
|---|---|---|---|
| `month` | string | yes | Month as YYYY-MM. |

Returns the monthly Revenue report: total earnings, then the split by channel and by course, with refunds and tax withheld. One month per call; the current month is partial until Udemy closes it.

Example response:

```json
{
  "month": "2026-09",
  "currency": "USD",
  "total": 2310.4,
  "by_channel": [
    {
      "channel": "Udemy Organic",
      "amount": 1420.1
    },
    {
      "channel": "Your Promotions",
      "amount": 612.3
    },
    {
      "channel": "Udemy Business",
      "amount": 278
    }
  ],
  "by_course": [
    {
      "course_id": "4821736",
      "title": "Python for Beginners",
      "amount": 1790.2
    },
    {
      "course_id": "5102298",
      "title": "Excel Pivot Tables",
      "amount": 520.2
    }
  ],
  "refunds": 41.5,
  "tax_withheld": 0
}
```

### list_coupons

Coupons of a course with code, type, price, redemptions and expiry, plus how many you can still create this month. Access: read. REST: `POST /api/v1/udemy/list_coupons`.

| Parameter | Type | Required | Description |
|---|---|---|---|
| `course_id` | string | yes | Course ID from list_courses. |
| `active_only` | boolean | no | Skip expired coupons. Default: true. |

Lists the coupons of one course, newest first, with type, price, redemptions and expiry. It also returns how many new coupons you can still create this month, because Udemy limits that number per course.

Example response:

```json
{
  "coupons": [
    {
      "coupon_id": "9917000",
      "code": "SEPT1499",
      "type": "custom_price",
      "price": "14.99",
      "redemptions": 37,
      "expires_at": "2026-10-05T09:00:00-07:00"
    }
  ],
  "coupons_left_this_month": 2
}
```

### list_reviews

Course reviews with rating, text, date and your response if any. Access: read. REST: `POST /api/v1/udemy/list_reviews`.

| Parameter | Type | Required | Description |
|---|---|---|---|
| `course_id` | string | yes | Course ID from list_courses. |
| `rating` | integer | no | Only this star rating, 1 to 5. |
| `unresponded_only` | boolean | no | Skip reviews you already responded to. |
| `since` | date | no | Only reviews from this date on. |

Lists reviews of one course, newest first, with rating, text, date and your response if you wrote one. Filter by star rating or unresponded_only to find what still needs an answer.

Example response:

```json
{
  "reviews": [
    {
      "review_id": "rv_33801",
      "rating": 2,
      "text": "Pivot tables were skipped.",
      "created_at": "2026-10-02T11:20:00Z",
      "response": null
    }
  ],
  "next_cursor": null
}
```

### list_questions

Questions from the course Q&A with lecture, text, replies and whether it is answered. Access: read. REST: `POST /api/v1/udemy/list_questions`.

| Parameter | Type | Required | Description |
|---|---|---|---|
| `course_id` | string | yes | Course ID from list_courses. |
| `unanswered_only` | boolean | no | Only questions with no instructor reply. |
| `since` | date | no | Only questions from this date on. |

Lists questions from the course Q&A, newest first, each with its lecture, text and replies. Set unanswered_only to see questions with no instructor reply.

Example response:

```json
{
  "questions": [
    {
      "question_id": "q_70418",
      "lecture": "Filters in Excel",
      "text": "How do I toggle filters faster?",
      "created_at": "2026-10-06T08:12:00Z",
      "answered": false,
      "replies": []
    }
  ],
  "next_cursor": null
}
```

### create_coupon

New coupon for a course, within Udemy's monthly limit per course; Udemy sets each type's duration. Access: write, asks the user first. REST: `POST /api/v1/udemy/create_coupon`.

| Parameter | Type | Required | Description |
|---|---|---|---|
| `course_id` | string | yes | Course ID from list_courses. |
| `type` | enum | yes | best_price, custom_price, free_open or free_targeted. |
| `code` | string | no | Your own coupon code. Default: generated. |
| `price` | string | no | For custom_price: an amount inside the range Udemy offers, e.g. 12.99. |
| `starts_at` | datetime | no | Activation time, ISO 8601 with time zone, inside the current calendar month in U.S. Pacific Time. Default: now. |

Creates one coupon for a course and returns its code and link. Udemy's rule is three new coupons per course per calendar month, and Udemy does not let you delete a coupon afterwards. A custom price must be inside the range Udemy offers. By default you confirm each call; you can switch that off for this tool.

Example response:

```json
{
  "coupon_id": "9917342",
  "course_id": "4821736",
  "code": "OCTOBER1299",
  "type": "custom_price",
  "price": "12.99",
  "currency": "USD",
  "starts_at": "2026-10-12T09:00:00-07:00",
  "expires_at": "2026-11-12T09:00:00-08:00",
  "url": "https://www.udemy.com/course/python-for-yourname/?couponCode=OCTOBER1299",
  "coupons_left_this_month": 2
}
```

### update_course_landing_page

Change the title, subtitle or description shown on the public course page. Access: write, asks the user first. REST: `POST /api/v1/udemy/update_course_landing_page`.

| Parameter | Type | Required | Description |
|---|---|---|---|
| `course_id` | string | yes | Course ID from list_courses. |
| `fields` | object | yes | Any of title, subtitle, description_markdown. |

Changes the title, subtitle or description of the public course page. Only the fields you pass change. Udemy may review changes to a published course before they show. By default you confirm each call; you can switch that off for this tool.

Example response:

```json
{
  "course_id": "4821736",
  "status": "saved",
  "updated": [
    "subtitle"
  ]
}
```

### send_announcement

Email enrolled students: an educational announcement or a promotional email, within the monthly limits Udemy sets per course. Access: write, asks the user first. REST: `POST /api/v1/udemy/send_announcement`.

| Parameter | Type | Required | Description |
|---|---|---|---|
| `course_id` | string | yes | Course ID from list_courses. |
| `kind` | enum | yes | educational or promotional. |
| `subject` | string | yes | Email subject. |
| `body_markdown` | string | yes | Message body. Udemy's announcement rules apply. |

Sends one message to the students enrolled in a course. Udemy's rules allow 4 educational announcements and 2 promotional emails per course per month, and promotional emails may not contain external links. By default you confirm each call; you can switch that off for this tool.

Example response:

```json
{
  "announcement_id": "an_2204",
  "course_id": "4821736",
  "kind": "educational",
  "status": "sent",
  "sent_at": "2026-10-12T10:00:00-04:00"
}
```

### reply_to_question

Post an instructor answer in the course Q&A. Access: write, asks the user first. REST: `POST /api/v1/udemy/reply_to_question`.

| Parameter | Type | Required | Description |
|---|---|---|---|
| `question_id` | string | yes | Question ID from list_questions. |
| `body` | string | yes | Answer text. |

Posts an answer under your instructor name in the course Q&A, visible to every student of the course. By default you confirm each call; you can switch that off for this tool.

Example response:

```json
{
  "question_id": "q_70418",
  "reply_id": "rp_9081",
  "status": "published"
}
```

### respond_to_review

Public instructor response under a student review. Access: write, asks the user first. REST: `POST /api/v1/udemy/respond_to_review`.

| Parameter | Type | Required | Description |
|---|---|---|---|
| `review_id` | string | yes | Review ID from list_reviews. |
| `body` | string | yes | Response text. |

Posts a public response under one student review, as you. By default you confirm each call; you can switch that off for this tool.

Example response:

```json
{
  "review_id": "rv_33801",
  "status": "published"
}
```

## How do I connect Udemy to Claude Code, Codex or Cursor?

Connecting Udemy takes three steps: request access, sign in to Udemy once, then add one MCP server or call the REST API with the same key.

### Connect Udemy to your agent.

1. **Create an account** Sign up and add Udemy in the console. Your API key is there too.

2. **Sign in to Udemy once** Open the connect page from the console and sign in to Udemy the way you always do. We keep the session, never your password, and you can revoke it anytime.

3. **Add Cotlet to your agent** Paste the snippet for your client. The same server and key serve every app you connect, so you do this once.

   Claude Code:

```
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
```

   Cursor:

```
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}
```

   Codex:

```
# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```

4. **Ask your agent** Ask in plain words. Your agent finds the Udemy tools on the server and calls them for you; anything that reaches other people waits for your OK unless you switch that off for a tool.

```
On the 1st of each month, create a custom price coupon at $12.99 for each of my paid Udemy courses, starting 9:00 Pacific, and give me the links with expiry dates. Skip courses that still have an active coupon.
```

### Call Udemy from your scripts.

1. **Export your API key** Your scripts use the same API key as your agent. Keep it in an environment variable, never in your code.

```
export COTLET_API_KEY="cotlet_..."
```

2. **Call a tool** Every tool is a POST endpoint at /api/v1/udemy/{tool}. Send its parameters as JSON, exactly as listed in the endpoints above.

```
curl https://cotlet.dev/api/v1/udemy/create_coupon \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"course_id":"4821736","type":"custom_price","code":"OCTOBER1299","price":"12.99","starts_at":"2026-10-12T09:00:00-07:00"}'
```

3. **Read the result** You get plain JSON back, ready for your script. A failed call costs nothing.

```
{
  "coupon_id": "9917342",
  "course_id": "4821736",
  "code": "OCTOBER1299",
  "type": "custom_price",
  "price": "12.99",
  "currency": "USD",
  "starts_at": "2026-10-12T09:00:00-07:00",
  "expires_at": "2026-11-12T09:00:00-08:00",
  "url": "https://www.udemy.com/course/python-for-yourname/?couponCode=OCTOBER1299",
  "coupons_left_this_month": 2
}
```

## Why use Cotlet for Udemy?

**Built for agents**

- One MCP server for every app you connect.
- The same tools as a REST API for scripts and cron jobs.
- Works with Claude Code, Codex and Cursor.

**Your login stays yours**

- You sign in to Udemy yourself. We keep only the session, encrypted with AES-256.
- The model never sees a login.
- No stored passwords, no CAPTCHA solving, no MFA bypass.

**You stay in control**

- Pick read only, or read and write.
- Anything that reaches other people waits for your OK, unless you switch it off per tool.
- Revoke access in one click.

**Kept working for you**

- We test every integration daily.
- When Udemy changes, the tool pauses until we fix it.
- Failed calls cost nothing.

## Is there a Udemy MCP server on GitHub?

Yes. Community Udemy MCP servers exist on GitHub, usually maintained by one person. They wrap the Instructor API with a token you copy from your browser, so they cover only what that API allows. You install one on your own computer and keep it running yourself. Cotlet hosts the same kind of server for you, covers coupons, announcements and revenue too, and our team keeps it working.

|  | GitHub MCP server | Cotlet |
|---|---|---|
| Setup | Clone the repo, install it, paste a bearer token into a .env file, add it to each MCP client | Request access, sign in to Udemy once, add one MCP server or API key |
| When Udemy changes | It breaks until you or the maintainer fix it | Our team tests it daily and fixes it for you; failed calls are free |
| Your Udemy session | A token in a file on your computer, readable by any program you run | Encrypted in an EU vault, limited to the actions you allow, revoked in one click |
| When the session expires | Tools fail until you paste a new token | Your agent gets a link to sign in again |
| Upkeep | You update, monitor and debug it yourself | Nothing to host or update |
| Where it runs | Your computer, while it is on | Hosted: Claude Code, Codex, Cursor, n8n and scripts, also on a schedule |
| Price | Free, paid for with your time | Free 7-day trial with 5,000 credits, then credits per call |

### Which one fits you

**Pick Cotlet if**

- you are not a developer, or you do not want to maintain a server
- you need it to keep working when Udemy changes, without checking it yourself
- your agent or a script should run it on a schedule, also while your computer is off

**Pick an open-source server if**

- you are comfortable installing, updating and fixing it yourself
- you want the session to stay on your own computer
- you only need it now and then, from one MCP client

## How much does the Udemy API cost?

Free 7-day trial with 5,000 credits, no card needed. After that, the Udemy API comes with the Cotlet plan, from $29 a month for 3,000 credits, with no limit on apps. Each month's credits stay valid for 3 months, so unused credits add up.

| Size | Price | Credits / month | Per credit |
|---|---|---|---|
| Solo | $29/mo | 3,000 | about $0.0097 |
| Pro | $99/mo | 12,000 | about $0.0083 |
| Agency | $299/mo | 40,000 | $0.0075 |

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the `Authorization: Bearer` header. [See full pricing](https://cotlet.dev/pricing)

## How Cotlet holds your access

Cotlet hosts MCP servers and REST APIs for apps with no usable API. Your agent works in your own Udemy account.

- **Company details:** The legal name, address and registration numbers of the company behind Cotlet are in the Terms of service. [Terms](https://cotlet.dev/terms)
- **Your session:** You sign in to Udemy yourself, in your browser. We keep only the session, never your password: encrypted with AES-256 in an EU vault, isolated to your account and used only when your agent calls a Udemy tool you allowed. When it expires, your agent gives you a link to sign in again. [Security](https://cotlet.dev/security)
- **Revoking access:** Disconnect Udemy in your dashboard: the session is deleted and access ends at once. Actions that reach other people wait for your OK unless you switch that off per tool.
- **What we never do:** Store passwords, solve CAPTCHAs or bypass MFA.
- **Udemy's terms:** You use your own Udemy account and stay responsible for following Udemy's terms. Cotlet is independent and not affiliated with Udemy. [Terms](https://cotlet.dev/terms)
- **Contact:** Questions about the company, security or an app: [contact@cotlet.dev](mailto:contact@cotlet.dev)

## Frequently asked questions

**How do I get access?**

Request access and pick Udemy. Cotlet reviews each request and emails you your API key.

**Do I need to be technical?**

No. You sign in to Udemy once in your browser and paste one command into your agent, or one URL into n8n. Your agent can walk you through it. There is no server to install, update or fix.

**Is a hosted server safe? My Udemy session would leave my computer.**

Cotlet keeps your Udemy session encrypted with AES-256 in an EU vault, isolated to your account and used only for the tools you allow: read only, or read and write. The AI model never sees it, and you revoke it in one click. A local server keeps the same session in a file on your computer, readable by any program you run, and needs a fresh sign-in whenever it expires.

**Do I need an Instructor API token?**

No. Cotlet works in your own Udemy instructor account after you sign in once, so you do not create an API client or copy a token. The Udemy Instructor API is token based and covers courses, reviews (read only), Q&A and direct messages.

**Can my agent post or send messages in Udemy without asking me?**

No. Every call to create_coupon, update_course_landing_page, send_announcement, reply_to_question or respond_to_review waits for your OK by default. For scheduled automations you can switch confirmation off per tool in your dashboard, for example only for approvals.

**Can I use the Udemy API in n8n?**

Yes. Add https://cotlet.dev/mcp/v1 with your API key in n8n's MCP Client node, or call https://cotlet.dev/api/v1/udemy/{tool} from the HTTP Request node.