Get the IT contacts for an organization.
cURL
| curl "https://api.workos.com/organizations/org_01EHWNCE74X7JSDV0X3SZ3KJNY/it_contacts" \ | |
| --header "Authorization: Bearer sk_example_123456789" |
| require "workos" | |
| WorkOS.configure do |config| | |
| config.api_key = "sk_example_123456789" | |
| end | |
| WorkOS.client.organizations_it_contacts.list_organization_it_contacts(organization_id: "org_01EHWNCE74X7JSDV0X3SZ3KJNY") |
| from workos import WorkOSClient | |
| client = WorkOSClient(api_key="sk_example_123456789", client_id="client_123456789") | |
| client.organizations_it_contacts.list_organization_it_contacts( | |
| organization_id="org_01EHWNCE74X7JSDV0X3SZ3KJNY" | |
| ) |
| package main | |
| import ( | |
| "context" | |
| "github.com/workos/workos-go/v9" | |
| ) | |
| func main() { | |
| client := workos.NewClient("sk_example_123456789") | |
| _, err := client.OrganizationsItContacts().List(context.Background(), "org_01EHWNCE74X7JSDV0X3SZ3KJNY") | |
| if err != nil { | |
| panic(err) | |
| } | |
| } |
| <?php | |
| use WorkOS\WorkOS; | |
| $workos = new WorkOS( | |
| apiKey: "sk_example_123456789", | |
| clientId: "client_123456789", | |
| ); | |
| $workos | |
| ->organizationsItContacts() | |
| ->listOrganizationItContacts( | |
| organizationId: "org_01EHWNCE74X7JSDV0X3SZ3KJNY", | |
| ); |
| import com.workos.WorkOS; | |
| WorkOS workos = new WorkOS("sk_example_123456789"); | |
| workos.organizationsItContacts.listOrganizationItContacts( | |
| "org_01EHWNCE74X7JSDV0X3SZ3KJNY"); |
| using WorkOS; | |
| var client = new WorkOSClient(new WorkOSOptions { | |
| ApiKey = "sk_example_123456789", | |
| ClientId = "client_123456789", | |
| }); | |
| await client.OrganizationsItContacts.ListAsync("org_01EHWNCE74X7JSDV0X3SZ3KJNY"); |
| use workos::Client; | |
| #[tokio::main] | |
| async fn main() -> Result<(), workos::Error> { | |
| let client = Client::builder() | |
| .api_key("sk_example_123456789") | |
| .client_id("client_123456789") | |
| .build(); | |
| let _result = client | |
| .organizations_it_contacts() | |
| .list_organization_it_contacts("org_01EHWNCE74X7JSDV0X3SZ3KJNY") | |
| .await?; | |
| Ok(()) | |
| } |
| { | |
| "object": "list", | |
| "data": [ | |
| { | |
| "object": "it_contact", | |
| "id": "it_contact_01HXYZ123456789ABCDEFGHIJ", | |
| "email": "it-contact@example.com", | |
| "created_at": "2026-01-15T12:00:00.000Z", | |
| "updated_at": "2026-01-15T12:00:00.000Z" | |
| } | |
| ], | |
| "list_metadata": { | |
| "before": "it_contact_01HXYZ123456789ABCDEFGHIJ", | |
| "after": "it_contact_01HXYZ987654321KJIHGFEDCBA" | |
| } | |
| } |
GET/organizations
Parameters
Returns object
Add an IT contact to an organization. No Admin Portal invitation is sent, though the contact is notified if the organization has a connection certificate nearing expiry.
cURL
| curl --request POST \ | |
| --url "https://api.workos.com/organizations/org_01EHWNCE74X7JSDV0X3SZ3KJNY/it_contacts" \ | |
| --header "Authorization: Bearer sk_example_123456789" \ | |
| --header "Content-Type: application/json" \ | |
| -d @- <<'BODY' | |
| { | |
| "email": "it-contact@example.com" | |
| } | |
| BODY |
| require "workos" | |
| WorkOS.configure do |config| | |
| config.api_key = "sk_example_123456789" | |
| end | |
| WorkOS.client.organizations_it_contacts.create_organization_it_contact( | |
| organization_id: "org_01EHWNCE74X7JSDV0X3SZ3KJNY", | |
| email: "it-contact@example.com" | |
| ) |
| from workos import WorkOSClient | |
| client = WorkOSClient(api_key="sk_example_123456789", client_id="client_123456789") | |
| client.organizations_it_contacts.create_organization_it_contact( | |
| organization_id="org_01EHWNCE74X7JSDV0X3SZ3KJNY", email="it-contact@example.com" | |
| ) |
| package main | |
| import ( | |
| "context" | |
| "github.com/workos/workos-go/v9" | |
| ) | |
| func main() { | |
| client := workos.NewClient("sk_example_123456789") | |
| _, err := client.OrganizationsItContacts().Create(context.Background(), "org_01EHWNCE74X7JSDV0X3SZ3KJNY", &workos.OrganizationsItContactsCreateParams{ | |
| Email: "it-contact@example.com", | |
| }) | |
| if err != nil { | |
| panic(err) | |
| } | |
| } |
| <?php | |
| use WorkOS\WorkOS; | |
| $workos = new WorkOS( | |
| apiKey: "sk_example_123456789", | |
| clientId: "client_123456789", | |
| ); | |
| $workos | |
| ->organizationsItContacts() | |
| ->createOrganizationItContact( | |
| organizationId: "org_01EHWNCE74X7JSDV0X3SZ3KJNY", | |
| email: "it-contact@example.com", | |
| ); |
| import com.workos.WorkOS; | |
| import com.workos.organizationsitcontacts.OrganizationsItContactsApi.CreateOrganizationItContactOptions; | |
| WorkOS workos = new WorkOS("sk_example_123456789"); | |
| CreateOrganizationItContactOptions options = | |
| CreateOrganizationItContactOptions.builder().email("it-contact@example.com").build(); | |
| workos.organizationsItContacts.createOrganizationItContact( | |
| "org_01EHWNCE74X7JSDV0X3SZ3KJNY", options); |
| using WorkOS; | |
| var client = new WorkOSClient(new WorkOSOptions { | |
| ApiKey = "sk_example_123456789", | |
| ClientId = "client_123456789", | |
| }); | |
| await client.OrganizationsItContacts.CreateAsync("org_01EHWNCE74X7JSDV0X3SZ3KJNY", | |
| new OrganizationsItContactsCreateOptions { | |
| Email = "it-contact@example.com", | |
| }); |
| use workos::Client; | |
| use workos::organizations_it_contacts::CreateOrganizationItContactParams; | |
| #[tokio::main] | |
| async fn main() -> Result<(), workos::Error> { | |
| let client = Client::builder() | |
| .api_key("sk_example_123456789") | |
| .client_id("client_123456789") | |
| .build(); | |
| let _result = client | |
| .organizations_it_contacts() | |
| .create_organization_it_contact( | |
| "org_01EHWNCE74X7JSDV0X3SZ3KJNY", | |
| CreateOrganizationItContactParams { | |
| email: "it-contact@example.com".into(), | |
| ..Default::default() | |
| } | |
| ) | |
| .await?; | |
| Ok(()) | |
| } |
| { | |
| "object": "it_contact", | |
| "id": "it_contact_01HXYZ123456789ABCDEFGHIJ", | |
| "email": "it-contact@example.com", | |
| "created_at": "2026-01-15T12:00:00.000Z", | |
| "updated_at": "2026-01-15T12:00:00.000Z" | |
| } |
POST/organizations
Parameters
Returns
Remove an IT contact from an organization.
cURL
| curl --request DELETE \ | |
| --url "https://api.workos.com/organizations/org_01EHWNCE74X7JSDV0X3SZ3KJNY/it_contacts/it_contact_01HXYZ123456789ABCDEFGHIJ" \ | |
| --header "Authorization: Bearer sk_example_123456789" |
| require "workos" | |
| WorkOS.configure do |config| | |
| config.api_key = "sk_example_123456789" | |
| end | |
| WorkOS.client.organizations_it_contacts.delete_organization_it_contact( | |
| organization_id: "org_01EHWNCE74X7JSDV0X3SZ3KJNY", | |
| contact_id: "it_contact_01HXYZ123456789ABCDEFGHIJ" | |
| ) |
| from workos import WorkOSClient | |
| client = WorkOSClient(api_key="sk_example_123456789", client_id="client_123456789") | |
| client.organizations_it_contacts.delete_organization_it_contact( | |
| organization_id="org_01EHWNCE74X7JSDV0X3SZ3KJNY", | |
| contact_id="it_contact_01HXYZ123456789ABCDEFGHIJ", | |
| ) |
| package main | |
| import ( | |
| "context" | |
| "github.com/workos/workos-go/v9" | |
| ) | |
| func main() { | |
| client := workos.NewClient("sk_example_123456789") | |
| _, err := client.OrganizationsItContacts().Delete(context.Background(), "org_01EHWNCE74X7JSDV0X3SZ3KJNY", "it_contact_01HXYZ123456789ABCDEFGHIJ") | |
| if err != nil { | |
| panic(err) | |
| } | |
| } |
| <?php | |
| use WorkOS\WorkOS; | |
| $workos = new WorkOS( | |
| apiKey: "sk_example_123456789", | |
| clientId: "client_123456789", | |
| ); | |
| $workos | |
| ->organizationsItContacts() | |
| ->deleteOrganizationItContact( | |
| organizationId: "org_01EHWNCE74X7JSDV0X3SZ3KJNY", | |
| contactId: "it_contact_01HXYZ123456789ABCDEFGHIJ", | |
| ); |
| import com.workos.WorkOS; | |
| WorkOS workos = new WorkOS("sk_example_123456789"); | |
| workos.organizationsItContacts.deleteOrganizationItContact( | |
| "org_01EHWNCE74X7JSDV0X3SZ3KJNY", "it_contact_01HXYZ123456789ABCDEFGHIJ"); |
| using WorkOS; | |
| var client = new WorkOSClient(new WorkOSOptions { | |
| ApiKey = "sk_example_123456789", | |
| ClientId = "client_123456789", | |
| }); | |
| await client.OrganizationsItContacts.DeleteAsync("org_01EHWNCE74X7JSDV0X3SZ3KJNY", | |
| "it_contact_01HXYZ123456789ABCDEFGHIJ"); |
| use workos::Client; | |
| #[tokio::main] | |
| async fn main() -> Result<(), workos::Error> { | |
| let client = Client::builder() | |
| .api_key("sk_example_123456789") | |
| .client_id("client_123456789") | |
| .build(); | |
| let _result = client | |
| .organizations_it_contacts() | |
| .delete_organization_it_contact( | |
| "org_01EHWNCE74X7JSDV0X3SZ3KJNY", | |
| "it_contact_01HXYZ123456789ABCDEFGHIJ" | |
| ) | |
| .await?; | |
| Ok(()) | |
| } |
DELETE/organizations
Parameters
Returns
Magic Link Continue to the next section
Up next