POST /notes

Description Create a note
Method & URL
POST https://api.findery.com/v2/notes
Scope notes
Parameters
access_token
Required. This is the authentication token for the user that is creating the note.
title
At least one of title or message is required. This is the title of the note. If no title is added, one will be created based on the 'message' contents.
message
At least one of title or message is required. This is the main text of the note.
visibility
Required. One of self, recipients, or public. If recipients, an additional parameter called recipients with an array of user IDs is expected.
location
Required. Location is a hash with the required fields latitude and longitude with both in decimal degrees. In addition, location may accept an optional human-readable address (e.g., "1600 Pennsylvania Avenue, Washington, D.C., United States") and optional zoom_level that corresponds to Google Maps API zoom level and may be used in note presentation in certain contexts. Finally, a note may also be added to a place in one of two ways:
  • To create a new brand new place (e.g., "my favorite couch"), simply add name field to the location hash.
  • To add a note to an existing place (e.g. "Golden Gate Bridge"), instead include an id field with the place's ID as its value.
tags
Optional. This takes an array of strings, where each string is the tag name.
image_file
Optional. This is the content of the image file to upload. We support any JPEGs, PNGs, and GIFs up to 20 MBs.
Example Request
curl -X POST -H "Authorization: Bearer ACCESS_TOKEN" --data "title=testmessage&location[latitude]=37.7&location[longitude]=-120.1&visibility=public"  https://api.findery.com/v2/notes
Example Response
{
    "data": {
        "author": {
            "avatar": {
                "hasAvatar": false,
                "hash": "c35b4cf1ce6644ff4b2b26983677282c",
                "urlRoot": "https://s3-us-west-1.amazonaws.com/avatars1.dev.findery.com/default/"
            },
            "id": 257699140080,
            "link": "https://findery.com/MRMAN",
            "name": null,
            "username": "MRMAN"
        },
        "comments": {
            "meta": {
                "count": 0,
                "nextUrl": "/v2/notes/932009001403/comments"
            }
        },
        "createdAt": 1415156288,
        "currentUserData": {
            "canComment": true,
            "canFavorite": true,
            "isFavorited": false,
            "isFound": false,
            "isUnfound": false
        },
        "displayAddress": null,
        "favoriters": {
            "meta": {
                "count": 0,
                "nextUrl": "/v2/notes/932009001403/favoriters"
            }
        },
        "finders": {
            "meta": {
                "count": 0,
                "nextUrl": "/v2/notes/932009001403/finders"
            }
        },
        "id": 932009001403,
        "link": "https://findery.com/MRMAN/notes/testmessage234234-5",
        "location": {
            "city": "Coulterville",
            "country": "United States",
            "isoCountryCode": "US",
            "latitude": 37.7,
            "longitude": -120.1,
            "neighborhood": null,
            "postalCode": "95311",
            "state": "California",
            "street": "Ponderosa Way",
            "streetAddress": "Stanislaus National Forest, 9416 Ponderosa Way, Coulterville, CA 95311, USA",
            "streetNumber": "9416",
            "zoomLevel": 13
        },
        "message": null,
        "notemaps": {
            "meta": {
                "count": 0,
                "nextUrl": "/v2/notes/932009001403/notemaps"
            }
        },
        "tags": {
            "meta": {
                "count": 0,
                "nextUrl": "/v2/notes/932009001403/tags"
            }
        },
        "title": "testmessage234234",
        "updatedAt": 1415156288,
        "visibility": "public"
    },
    "meta": {
        "http_status": 201
    }
}