### Public Beta Feature

This documentation covers a feature currently in Public Beta. Access is available to anyone interested in building personalized experiences for their end-users.

This feature is subject to the [Personalization API (Self-Service) Public Beta End user License Agreement](https://location.foursquare.com/legal/terms/personalization-apis-self-service-eula/).

---

**Parameters**

- **version**  
  `string`  
  required  
  The API version date as documented [here](https://docs.foursquare.com/developer/reference/versioning); e.g. 20231010

- **venueId**  
  `string`  
  required  
  The venue where you want to add this tip.

- **text**  
  `string`  
  required  
  The text of the tip, up to 200 characters.

- **accept**  
  `string`  
  enum  
  Defaults to application/json

Generated from available response content types  
  `application/json` `text/plain`

# HTTP Responses

## 200

**Response when adding a tip to a venue.**

- **meta**  
  - **code**  
    `integer`  
    Defaults to 0  
    Status code indicating the result of adding a tip to the endpoint.

- **requestId**  
    `string`  
    Unique identifier for the API request.

- **notifications**  
  `array of objects`  
  Array of notification objects for successful creation of a new tip.

- **item**  
    `object`  
    Notification item for successfully adding a tip.

- **type**  
      `string`  
      Type of notification for successful addition of a tip.

- **response**  
  `object`  
  The response object for successfully adding a tip.

- **tip**  
    `object`  
    The response object for adding a tip, including the newly created tip.

## Example cURL Request

```bash
curl --request POST \
     --url https://api.foursquare.com/v2/tips/add \
     --header 'accept: application/json'
```

## Example JSON Response

```json
{
  "meta": {
    "code": 200,
    "requestId": "64138356813165221a961758"
  },
  "notifications": [
    {
      "type": "notificationTray",
      "item": {
        "unreadCount": 0
      }
    }
  ],
  "response": {
    "tip": {
      "id": "64138356a21d0758343e8135",
      "createdAt": 1679000406,
      "text": "Best coffee in town!",
      "type": "user",
      "canonicalUrl": "https://foursquare.com/item/64138356a21d0758343e8135",
      "canonicalPath": "/item/64138356a21d0758343e8135",
      "likes": {
        "count": 0,
        "groups": []
      },
      "viewCount": 0,
      "agreeCount": 0,
      "disagreeCount": 0,
      "venue": {
        "id": "56e845f7498e8880e6c39afa",
        "name": "Starbucks"
      },
      "user": {
        "id": "7294631",
        "firstName": "Bat",
        "lastName": "Macumba",
        "gender": "male",
        "countryCode": "US",
        "relationship": "self",
        "canonicalUrl": "https://foursquare.com/user/7294631",
        "canonicalPath": "/user/7294631",
        "photo": {
          "prefix": "https://fastly.4sqi.net/img/user/",
          "suffix": "/blank_boy.png",
          "default": true
        },
        "isAnonymous": false
      },
      "title": "Bat's tip"
    }
  }
}
```

---