Create HID Org
Enterprise only
Register one of your existing HID Origo organizations. Add the returned hid_admin_email address as an admin user in your Origo portal with the Org Admin, MI Administrator and RM Administrator roles. Setup runs from there, ending at completed.
name
string
All
Request
# Build the JSON payload
PAYLOAD='{"name":"My Org"}'
# Sign the payload
PAYLOAD_B64=$(printf '%s' "$PAYLOAD" | openssl base64 -A)
SIG=$(printf '%s' "$PAYLOAD_B64" | openssl dgst -sha256 -hmac "$SECRET_KEY" -hex | awk '{print $NF}')
curl -X POST \
-H "X-ACCT-ID: $ACCOUNT_ID" \
-H "X-PAYLOAD-SIG: $SIG" \
-H "Content-Type: application/json" \
-d "$PAYLOAD" \
"https://api.accessgrid.com/v1/console/hid/orgs"
require 'accessgrid'
account_id = ENV['ACCOUNT_ID']
secret_key = ENV['SECRET_KEY']
client = AccessGrid::Client.new(account_id, secret_key)
# Create HID org
org = client.console.hid.orgs.create(
name: 'My Org',
email: '[email protected]',
full_address: '1 Main St, NY NY',
phone: '+1-555-0000',
first_name: 'Ada',
last_name: 'Lovelace'
)
puts "Created org: #{org.name} (ID: #{org.id})"
puts "Slug: #{org.slug}"
import AccessGrid from 'accessgrid';
const accountId = process.env.ACCOUNT_ID;
const secretKey = process.env.SECRET_KEY;
const client = new AccessGrid(accountId, secretKey);
const createOrg = async () => {
try {
// Create HID org
const org = await client.console.hid.orgs.create({
name: 'My Org',
email: '[email protected]',
fullAddress: '1 Main St, NY NY',
phone: '+1-555-0000',
firstName: 'Ada',
lastName: 'Lovelace'
});
console.log(`Created org: ${org.name} (ID: ${org.id})`);
console.log(`Slug: ${org.slug}`);
} catch (error) {
console.error('Error creating HID org:', error);
}
};
createOrg();
from accessgrid import AccessGrid
import os
account_id = os.getenv('ACCOUNT_ID')
secret_key = os.getenv('SECRET_KEY')
client = AccessGrid(account_id, secret_key)
# Create HID org
org = client.console.hid.orgs.create(
name='My Org',
email='[email protected]',
full_address='1 Main St, NY NY',
phone='+1-555-0000',
first_name='Ada',
last_name='Lovelace'
)
print(f"Created org: {org.name} (ID: {org.id})")
print(f"Slug: {org.slug}")
package main
import (
"context"
"fmt"
"os"
"github.com/Access-Grid/accessgrid-go"
)
func main() {
accountID := os.Getenv("ACCOUNT_ID")
secretKey := os.Getenv("SECRET_KEY")
client, err := accessgrid.NewClient(accountID, secretKey)
if err != nil {
fmt.Printf("Error creating client: %v\n", err)
return
}
ctx := context.Background()
org, err := client.Console.HID.Orgs.Create(ctx, &accessgrid.CreateHIDOrgParams{
Name: "My Org",
Email: "[email protected]",
FullAddress: "1 Main St, NY NY",
Phone: "+1-555-0000",
FirstName: "Ada",
LastName: "Lovelace",
})
if err != nil {
fmt.Printf("Error creating org: %v\n", err)
return
}
fmt.Printf("Created org: %s (ID: %s)\n", org.Name, org.ID)
fmt.Printf("Slug: %s\n", org.Slug)
}
using AccessGrid;
using System;
using System.Threading.Tasks;
public async Task CreateOrgAsync()
{
var accountId = Environment.GetEnvironmentVariable("ACCOUNT_ID");
var secretKey = Environment.GetEnvironmentVariable("SECRET_KEY");
var client = new AccessGridClient(accountId, secretKey);
// Create HID org
var org = await client.Console.HID.Orgs.CreateAsync(new CreateHIDOrgRequest
{
Name = "My Org",
Email = "[email protected]",
FullAddress = "1 Main St, NY NY",
Phone = "+1-555-0000",
FirstName = "Ada",
LastName = "Lovelace"
});
Console.WriteLine($"Created org: {org.Name} (ID: {org.Id})");
Console.WriteLine($"Slug: {org.Slug}");
}
import com.organization.accessgrid.AccessGridClient;
import com.organization.accessgrid.model.HIDOrg;
import com.organization.accessgrid.model.CreateHIDOrgParams;
public class HIDOrgService {
private final AccessGridClient client;
public HIDOrgService() {
String accountId = System.getenv("ACCOUNT_ID");
String secretKey = System.getenv("SECRET_KEY");
this.client = new AccessGridClient(accountId, secretKey);
}
public void createOrg() throws AccessGridException {
// Create HID org
CreateHIDOrgParams params = CreateHIDOrgParams.builder()
.name("My Org")
.email("[email protected]")
.fullAddress("1 Main St, NY NY")
.phone("+1-555-0000")
.firstName("Ada")
.lastName("Lovelace")
.build();
HIDOrg org = client.console().hid().orgs().create(params);
System.out.printf("Created org: %s (ID: %d)%n", org.getName(), org.getId());
System.out.printf("Slug: %s%n", org.getSlug());
}
}
{:ok, client} = AccessGrid.Client.new(
System.get_env("ACCOUNT_ID"),
System.get_env("SECRET_KEY")
)
# Create HID org
{:ok, org} = AccessGrid.Console.HID.Orgs.create(client,
name: "My Org",
full_address: "1 Main St, NY NY",
phone: "+1-555-0000",
first_name: "Ada",
last_name: "Lovelace"
)
IO.puts("Created org: #{org.name} (ID: #{org.id})")
IO.puts("Slug: #{org.slug}")
Response
{
"id": "91c2a7e4",
"name": "My Org",
"slug": "my-org",
"hid_admin_email": "<designated-email>",
"email": null,
"first_name": null,
"last_name": null,
"phone": null,
"full_address": null,
"status": "awaiting_invite",
"created_at": "2024-08-12T11:32:45Z"
}
List HID Orgs
Enterprise only
List the HID orgs registered under the current enterprise or partner account, newest first. Use it to look up an org's hid_admin_email or check its status.
Request
# Build the JSON payload
PAYLOAD="{}"
# Sign the payload
PAYLOAD_B64=$(printf '%s' "$PAYLOAD" | openssl base64 -A)
SIG=$(printf '%s' "$PAYLOAD_B64" | openssl dgst -sha256 -hmac "$SECRET_KEY" -hex | awk '{print $NF}')
curl -G \
-H "X-ACCT-ID: $ACCOUNT_ID" \
-H "X-PAYLOAD-SIG: $SIG" \
--data-urlencode "sig_payload=$PAYLOAD" \
"https://api.accessgrid.com/v1/console/hid/orgs"
require 'accessgrid'
account_id = ENV['ACCOUNT_ID']
secret_key = ENV['SECRET_KEY']
client = AccessGrid::Client.new(account_id, secret_key)
# List all HID orgs
orgs = client.console.hid.orgs.list
# Print orgs
orgs.each do |org|
puts "Org ID: #{org.id}, Name: #{org.name}, Slug: #{org.slug}"
end
import AccessGrid from 'accessgrid';
const accountId = process.env.ACCOUNT_ID;
const secretKey = process.env.SECRET_KEY;
const client = new AccessGrid(accountId, secretKey);
const listOrgs = async () => {
try {
// List all HID orgs
const orgs = await client.console.hid.orgs.list();
// Print orgs
orgs.forEach(org => {
console.log(`Org ID: ${org.id}, Name: ${org.name}, Slug: ${org.slug}`);
});
} catch (error) {
console.error('Error listing HID orgs:', error);
}
};
listOrgs();
from accessgrid import AccessGrid
import os
account_id = os.getenv('ACCOUNT_ID')
secret_key = os.getenv('SECRET_KEY')
client = AccessGrid(account_id, secret_key)
# List all HID orgs
orgs = client.console.hid.orgs.list()
# Print orgs
for org in orgs:
print(f"Org ID: {org.id}, Name: {org.name}, Slug: {org.slug}")
package main
import (
"context"
"fmt"
"os"
"github.com/Access-Grid/accessgrid-go"
)
func main() {
accountID := os.Getenv("ACCOUNT_ID")
secretKey := os.Getenv("SECRET_KEY")
client, err := accessgrid.NewClient(accountID, secretKey)
if err != nil {
fmt.Printf("Error creating client: %v\n", err)
return
}
ctx := context.Background()
orgs, err := client.Console.HID.Orgs.List(ctx)
if err != nil {
fmt.Printf("Error listing orgs: %v\n", err)
return
}
for _, org := range orgs {
fmt.Printf("Org ID: %s, Name: %s, Slug: %s\n", org.ID, org.Name, org.Slug)
}
}
using AccessGrid;
using System;
using System.Threading.Tasks;
public async Task ListOrgsAsync()
{
var accountId = Environment.GetEnvironmentVariable("ACCOUNT_ID");
var secretKey = Environment.GetEnvironmentVariable("SECRET_KEY");
var client = new AccessGridClient(accountId, secretKey);
// List all HID orgs
var orgs = await client.Console.HID.Orgs.ListAsync();
// Print orgs
foreach (var org in orgs)
{
Console.WriteLine($"Org ID: {org.Id}, Name: {org.Name}, Slug: {org.Slug}");
}
}
import com.organization.accessgrid.AccessGridClient;
import com.organization.accessgrid.model.HIDOrg;
import java.util.List;
public class HIDOrgService {
private final AccessGridClient client;
public HIDOrgService() {
String accountId = System.getenv("ACCOUNT_ID");
String secretKey = System.getenv("SECRET_KEY");
this.client = new AccessGridClient(accountId, secretKey);
}
public void listOrgs() throws AccessGridException {
// List all HID orgs
List<HIDOrg> orgs = client.console().hid().orgs().list();
// Print orgs
for (HIDOrg org : orgs) {
System.out.printf("Org ID: %d, Name: %s, Slug: %s%n",
org.getId(),
org.getName(),
org.getSlug());
}
}
}
{:ok, client} = AccessGrid.Client.new(
System.get_env("ACCOUNT_ID"),
System.get_env("SECRET_KEY")
)
# List all HID orgs
{:ok, orgs} = AccessGrid.Console.HID.Orgs.list(client)
# Print orgs
Enum.each(orgs, fn org ->
IO.puts("Org ID: #{org.id}, Name: #{org.name}, Slug: #{org.slug}")
end)
Response
[
{
"id": "91c2a7e4",
"name": "Acme Corporation",
"slug": "acme-corp",
"hid_admin_email": "<designated-email>",
"email": null,
"first_name": null,
"last_name": null,
"phone": null,
"full_address": null,
"status": "awaiting_invite",
"created_at": "2024-08-12T11:32:45Z"
},
{
"id": "b73d9f21",
"name": "Globex Industries",
"slug": "globex-industries",
"hid_admin_email": "<designated-email>",
"email": null,
"first_name": null,
"last_name": null,
"phone": null,
"full_address": null,
"status": "completed",
"created_at": "2025-02-03T09:18:10Z"
}
]