POST https://api.findery.com/v2/notes

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.

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

{
    "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
    }
}