Create relationship

Creates a new relationship between a note and another entity.

You can link a note to:

• A Product Management entity (e.g. feature, component, initiative)
• A customer entity (company or user)

This is useful for capturing customer feedback and tying it to the right product hierarchy, or for attributing a note to a specific customer.

If a Customer relationship already exists (user or company), it will be replaced. Notes can have one customer relationship and multiple product hierarchy relationships.

Code examples

• Replace <note-id> with the ID of the note you want to link.
• Replace <target-id> with the ID of the entity you want to link to.
• Replace <your-token> with a valid API token.

Link a note to a feature (Product hierarchy item):

curl -X POST "https://api.productboard.com/v2/notes/<note-id>/relationships" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "hierarchyItem",
      "target": {
        "id": "<target-id>",
        "type": "hierarchyItem"
      }
    }
  }'

Link a note to a customer company:

curl -X POST "https://api.productboard.com/v2/notes/<note-id>/relationships" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "company",
      "target": {
        "id": "<target-id>",
        "type": "company"
      }
    }
  }'