---
title: "Returns the newly created comment on success"
method: POST
path: "/tracks/{track_urn}/comments"
tags: ["tracks"]
---

# Returns the newly created comment on success

`POST /tracks/{track_urn}/comments`

## Request

- Base URL: `https://api.soundcloud.com`
- URL: `https://api.soundcloud.com/tracks/{track_urn}/comments`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://secure.soundcloud.com/authorize`
    - Client credentials
    - Token URL: `https://secure.soundcloud.com/oauth/token`
- TypeScript: <https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification/docs/tracks/:track_urn/comments/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `track_urn` string, required

## Request body

- object
  - `comment` object
    - `body` string, required: Comment's content
    - `timestamp` union: Timestamp of a comment. String or float representation is supported
      - string
      - number

## Response `201`

Success

- Comment: User's Comment
  - `body` string: Comment body.
  - `created_at` string: Created timestamp.
  - `urn` string: Identifier.
  - `kind` string: Kind (comment).
  - `user_urn` string: User's identifier.
  - `timestamp` string: Timestamp.
  - `track_urn` string: Track's identifier.
  - `uri` string: Comment's URL.
  - `user` object: SoundCloud User object
    - `urn` string: unique identifier
    - `kind` string: kind of resource.
    - `permalink` string: permalink of the resource.
    - `username` string: username
    - `last_modified` string: last modified timestamp.
    - `uri` string: API resource URL.
    - `permalink_url` string: URL to the SoundCloud.com page.
    - `avatar_url` string: URL to a JPEG image.
    - `followers_count` integer: number of followers.
    - `followings_count` integer: number of followed users.
    - `reposts_count` integer: number of reposts from user

## Other responses

- `422`: Unprocessable Entity
- `429`: Too Many Requests

## Changes

- **2026-07-17** `ab7b2ffc0193`: 2 breaking, 2 info
  - the `allOf[#/components/schemas/Error]/errors/items/` response's property type changed from `string` to `object` for status `429`
  - the `errors/items/` response's property type changed from `string` to `object` for status `422`
  - added the optional property `allOf[#/components/schemas/Error]/errors/items/error_message` to the response with the `429` status
  - added the optional property `errors/items/error_message` to the response with the `422` status

[Operation history](https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification/changes/tracks/:track_urn/comments/post.md)

---

[API](https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification.md) - [All operations](https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification/revisions/0d057017b405?raw)