Skip to main content
The accounts resource allows you to create, list, and delete email accounts associated with your Jasni account.

List Accounts

Retrieve all email accounts:
const { accounts, total } = await jasni.accounts.list()

console.log(`Found ${total} accounts:`)
accounts.forEach(account => {
  console.log(`- ${account.email} (${account.name})`)
})

Response

interface Account {
  id: string
  email: string
  name: string
  created_at: string
}

interface ListAccountsResponse {
  accounts: Account[]
  total: number
}

Create Account

Create a new email account:
// Create with auto-generated username
const { account } = await jasni.accounts.create({
  name: 'My Account',
})
console.log('Created:', account.email)

// Create with specific username
const { account } = await jasni.accounts.create({
  username: 'support',
  name: 'Support Team',
})
// Result: [email protected]

Options

ParameterTypeRequiredDescription
usernamestringNoLocal part of the email address. Auto-generated if not provided.
namestringNoDisplay name for the account

Response

interface CreateAccountResponse {
  account: Account
  message: string
}

Delete Account

Delete an email account:
const result = await jasni.accounts.delete('[email protected]')
console.log(result.message) // "Account deleted successfully"

Response

interface DeleteAccountResponse {
  deleted_email: string
  message: string
}
Deleting an account is permanent. All emails and data associated with the account will be lost.

Example: Account Management

Here’s a complete example of managing accounts:
import { Jasni } from 'jasni-sdk'

const jasni = new Jasni('jsk_your_api_key')

async function manageAccounts() {
  // List existing accounts
  const { accounts } = await jasni.accounts.list()
  console.log('Current accounts:', accounts.map(a => a.email))
  
  // Create a new account
  const { account: newAccount } = await jasni.accounts.create({
    username: 'newsletter',
    name: 'Newsletter',
  })
  console.log('Created:', newAccount.email)
  
  // Delete an account
  await jasni.accounts.delete(newAccount.email)
  console.log('Deleted:', newAccount.email)
}

manageAccounts().catch(console.error)