This is an object representing an organization in Previsto. You can retrieve it to see properties on the organization like its current e-mail address, physical address etc.
You are only allowed to access the organization your account refers to.
The business's EU VAT number, CVR number in Denmark, TIN/EIN/SSN in US.
terminated
boolean
No
-
terminationTime
datetime
No
-
createdDate
datetime
No
-
trial
boolean
No
-
subscriptionPrice
number
No
Price for subscription in 1⁄100 of the monetary unit (fx. cents or øre)
subscriptionPeriod
string
No
'Monthly', 'Quarterly', 'SemiAnnually' or 'Annually'. Default is 'Monthly'.
subscriptionDiscount
number
No
-
subscriptionExpires
datetime
No
-
subscriptionType
string
No
'Free', 'Micro', 'Small', 'Medium' or 'Large'.
Create an organization
Definition
1
POST https://api.previsto.io/organizations
2
`
Copied!
Example Request
1
curl https://api.previsto.io/organizations \
2
-u sk_12345: \
3
-d name="Vinduespudser A/S"
Copied!
Example Response
1
{
2
"id": "acct_123123123",
3
"name": "Vinduespudser A/S",
4
"url": null,
5
"address": null,
6
"postalCode": null,
7
"city": null,
8
"countryCode": "DK",
9
"phone": null,
10
"email": null,
11
"registrationNo": null,
12
"terminated": false,
13
"terminationTime": null,
14
"createdDate": "2015-01-01T00:00:00Z",
15
"trial": true,
16
"subscriptionPrice": 0,
17
"subscriptionPeriod": "Monthly",
18
"subscriptionDiscount": 0.0,
19
"subscriptionExpires": null,
20
"subscriptionType": "Free",
21
"languageCode": "da",
22
"baseCurrency": "DKK",
23
"locked": false,
24
"subjectToVat": true,
25
"timeZone": "Europe/Copenhagen"
26
}
Copied!
Creates a new organization.
A user can only create a new organization if it is not related to an organization yet. When a user creates a new organization it will automatically become related to the created organization.
Arguments
Field
Type
Required
Description
name
string
Yes
Name of the business, fx. 'Vinduespudser A/S'
url
string
No
-
address
string
No
The street address, 'fx. Vesterbro 11'
postalCode
string
No
-
city
string
No
-
countryCode
string
No
2-letter ISO 3166-1 code, fx. 'DK'
phone
string
No
Full international phonenumber, fx. '+4522123456'
email
string
No
-
registrationNo
string
No
The business's EU VAT number, CVR number in Denmark, TIN/EIN/SSN in US.
languageCode
string
No
2-letter ISO 639-1 code, fx. 'da'
baseCurrency
string
No
3-letter ISO 4217 code, fx. 'DKK'
subjectToVat
boolean
No
-
timeZone
string
No
-
Returns
Returns an organization object if the call succeeded. If a invalid parameters are provided, the call will return an error.