({{, (RefLink[CreateDatabin, paclet:ref/CreateDatabin])[] 
creates a databin in the Wolfram Data Drop and returns the corresponding (RefLink[Databin, paclet:ref/Databin]) object.}, {, (RefLink[CreateDatabin, paclet:ref/CreateDatabin])[options]
creates a databin with the specified options.}})

OpenersNotesSection(Spacer1)Details

(RefLink[CreateDatabin, paclet:ref/CreateDatabin]) returns a (RefLink[Databin, paclet:ref/Databin]) object with a universally unique ID.

Options can be given as an association or a list. Possible options include:

The setting for the "Interpretation" option has the same form as the first argument of (RefLink[APIFunction, paclet:ref/APIFunction]).

(RefLink[Options, paclet:ref/Options])[databin] gives the options settings for a databin. (RefLink[SetOptions, paclet:ref/SetOptions]) can be used to reset them.

OpenersPrimaryExamplesSection(Spacer1)Examples  (4)

OpenersExampleSection0(Spacer1)Basic Examples  (2)

Create a new databin:

bin=CreateDatabin[]

Add a value to the databin:

DatabinAdd[bin,1234]

Add another value:

DatabinAdd[bin,5678]

Add data using the web API:

URLExecute["https://datadrop.wolframcloud.com/api/v1.0/Add",{"bin"->bin["UUID"],"data"->"hello world"}];

Retrieve all values from the databin:

Values[bin]

Create a databin with an interpretation:

bin=CreateDatabin["Interpretation"->{"city"->"City","temp"->Restricted["StructuredQuantity","DegreesCelsius"]}]

Add to the databin:

DatabinAdd[bin,<|"city"->"nyc","temp"->20.4|>]

DatabinAdd[bin,<|"city"->"LA","temp"->26.2|>]

Retrieve values from the databin:

Values[bin]

OpenersExampleSection1(Spacer1)Scope  (2)

Give a new databin with a name:

CreateDatabin[<|"Name"->"My new data bin"|>]

Create a private databin:

bin=CreateDatabin[<|Permissions->"Private"|>]

Only a cloud-connected user with permissions can read or write to the databin:

bin["Add","x"->1]

CloudDisconnect[]

bin["Add","x"->2]

({{DocumentationFooterIconsRelatedFunction.png, ({{See Also}, {(RefLink[Databin, paclet:ref/Databin])  ▪  (RefLink[DatabinUpload, paclet:ref/DatabinUpload])  ▪  (RefLink[DatabinAdd, paclet:ref/DatabinAdd])  ▪  (RefLink[CopyDatabin, paclet:ref/CopyDatabin])  ▪  (RefLink[Databins, paclet:ref/Databins])  ▪  (RefLink[CloudObject, paclet:ref/CloudObject])  ▪  (RefLink[CloudDeploy, paclet:ref/CloudDeploy])  ▪  (RefLink[CloudSymbol, paclet:ref/CloudSymbol])  ▪  (RefLink[CreateUUID, paclet:ref/CreateUUID])  ▪  (RefLink[APIFunction, paclet:ref/APIFunction])}})}})

({{DocumentationFooterIconsRelatedGuide.png, ({{Related Guides}, {▪(RefLinkPlain[Using the Wolfram Data Drop, paclet:guide/UsingTheWolframDataDrop])}, {▪(RefLinkPlain[Accessing External Services & APIs, paclet:guide/AccessingExternalServicesAndAPIs])}, {▪(RefLinkPlain[Using Connected Devices, paclet:guide/UsingConnectedDevices])}, {▪(RefLinkPlain[Persistent Storage, paclet:guide/PersistentStorage])}})}})

({{(Spacer1), ({{(Spacer1)Related Links}, {(Spacer1)▪(WebLink[(Spacer1)Wolfram Data Drop: Quick Reference, http://www.wolfram.com/datadrop/quick-reference/])}, {(WebLink[DocumentationFooterIconsRelatedLinks-EIWL.png(Spacer1)An Elementary Introduction to the Wolfram Language, https://www.wolfram.com/language/elementary-introduction/43-storing-things.html])(WebLink[: Storing Things, https://www.wolfram.com/language/elementary-introduction/43-storing-things.html])}})}})