List Accounts

Create an account under your organization, and generate a new Account key. Account keys are used to authenticate when sending Messages

Request

Endpoint

Messaging Plus expects a GET request

GET https://mplus.instagiv.com/account

Query strings

Key	Required	Description	Example
key	true	Organization API key	?key=aaaabbbbcccc111222333

Response

Body

Single account

{
    "accounts": [
        {
            "identifier": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "name": "ACME Client",
            "credits": 1000,
            "deleted": false
        }
    ]
}

Multiple accounts

{
    "accounts": [
        {
            "identifier": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "name": "ACME Client",
            "credits": 1000,
            "deleted": false
        },
        {
            "identifier": "2180ad64-f9e7-4e7a-a96b-9f71caefbb9b",
            "name": "Dev",
            "credits": -335,
            "deleted": false
        },
        {
            "identifier": "c4ec02a8-6c8f-4895-9d3b-49670728cfc3",
            "name": "Legacy Client",
            "credits": 0,
            "deleted": true
        }
    ]
}

Body parameters

Key	Expected value	Description
identifier	string	UUID assigned to the account (account-uuid)
name	string	The name you assigned to this account
credits	integer	Credits remaining on this account. Only relevant if you use the credits system
name	boolean	Whether this account has been deleted