1Fort office365 (v2) API
**Access:** requires a JWT access token.
**Access:** requires a JWT access token.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/1fort:1fort-office365-v2-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: 1Fort API Documentation office365 (v2) API
description: '# 1Fort API
REST API for the 1Fort insurance platform.'
termsOfService: https://www.1fort.com/
license:
name: Privately owned
version: v1
servers:
- url: https://api.1fort.com/apis/
security:
- Bearer: []
tags:
- name: office365 (v2)
x-displayName: Office365 (v2)
description: '**Access:** requires a JWT access token.'
paths:
/v2/broker/integrations/office365:
parameters: []
get:
operationId: v2_broker_integrations_office365_list
description: ''
parameters:
- name: search
in: query
description: A search term.
required: false
schema:
type: string
- name: ordering
in: query
description: Which field to use when ordering the results.
required: false
schema:
type: string
- name: limit
in: query
description: Number of results to return per page.
required: false
schema:
type: integer
- name: offset
in: query
description: The initial index from which to return the results.
required: false
schema:
type: integer
responses:
'200':
description: ''
content:
application/json:
schema:
required:
- count
- results
type: object
properties:
count:
type: integer
next:
type:
- string
- 'null'
format: uri
previous:
type:
- string
- 'null'
format: uri
results:
type: array
items:
$ref: '#/components/schemas/BrokerOffice365Integration'
'403':
description: Authentication credentials were invalid, absent or insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/GenericError'
'500':
description: Internal server error.
tags:
- office365 (v2)
summary: List Office365
/v2/broker/integrations/office365/connect:
parameters: []
get:
operationId: v2_broker_integrations_office365_connect
summary: Start Office365 integration for broker
description: 'Start the Office365 integration process for a broker agency.
This will return a URL that the user should be redirected to.'
parameters:
- name: search
in: query
description: A search term.
required: false
schema:
type: string
- name: ordering
in: query
description: Which field to use when ordering the results.
required: false
schema:
type: string
- name: limit
in: query
description: Number of results to return per page.
required: false
schema:
type: integer
- name: offset
in: query
description: The initial index from which to return the results.
required: false
schema:
type: integer
responses:
'200':
description: Office365 integration started
content:
application/json:
schema:
type: object
properties:
id:
description: Office365 integration ID
type: string
url:
description: Microsoft Authentication URL
type: string
'403':
description: Authentication credentials were invalid, absent or insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/GenericError'
'500':
description: Internal server error.
tags:
- office365 (v2)
/v2/broker/integrations/office365/individual:
parameters: []
get:
operationId: v2_broker_integrations_office365_individual_list
description: ViewSet for managing individual Office365 OAuth integrations.
parameters:
- name: search
in: query
description: A search term.
required: false
schema:
type: string
- name: ordering
in: query
description: Which field to use when ordering the results.
required: false
schema:
type: string
- name: limit
in: query
description: Number of results to return per page.
required: false
schema:
type: integer
- name: offset
in: query
description: The initial index from which to return the results.
required: false
schema:
type: integer
responses:
'200':
description: ''
content:
application/json:
schema:
required:
- count
- results
type: object
properties:
count:
type: integer
next:
type:
- string
- 'null'
format: uri
previous:
type:
- string
- 'null'
format: uri
results:
type: array
items:
$ref: '#/components/schemas/IndividualOffice365Integration'
'403':
description: Authentication credentials were invalid, absent or insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/GenericError'
'500':
description: Internal server error.
tags:
- office365 (v2)
summary: List Individual
/v2/broker/integrations/office365/individual/connect:
parameters: []
post:
operationId: v2_broker_integrations_office365_individual_connect
summary: Start individual Office365 OAuth flow
description: 'Start the Office365 OAuth flow for an individual user.
This will return a URL that the user should be redirected to.
The user''s email will be populated after they authenticate.'
responses:
'200':
description: OAuth flow started
content:
application/json:
schema:
type: object
properties:
id:
description: Integration ID
type: string
url:
description: OAuth authorization URL
type: string
'400':
description: Invalid input.
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
'403':
description: Authentication credentials were invalid, absent or insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/GenericError'
'500':
description: Internal server error.
tags:
- office365 (v2)
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/IndividualOffice365Integration'
required: true
/v2/broker/integrations/office365/individual/{id}:
parameters:
- name: id
in: path
required: true
schema:
type: string
get:
operationId: v2_broker_integrations_office365_individual_read
description: ViewSet for managing individual Office365 OAuth integrations.
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/IndividualOffice365Integration'
'403':
description: Authentication credentials were invalid, absent or insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/GenericError'
'404':
description: Object does not exist or caller has insufficient permissions to access it.
content:
application/json:
schema:
$ref: '#/components/schemas/APIException'
'500':
description: Internal server error.
tags:
- office365 (v2)
summary: Retrieve Individual
delete:
operationId: v2_broker_integrations_office365_individual_delete
description: ViewSet for managing individual Office365 OAuth integrations.
responses:
'204':
description: ''
'403':
description: Authentication credentials were invalid, absent or insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/GenericError'
'404':
description: Object does not exist or caller has insufficient permissions to access it.
content:
application/json:
schema:
$ref: '#/components/schemas/APIException'
'500':
description: Internal server error.
tags:
- office365 (v2)
summary: Delete Individual
/v2/broker/integrations/office365/{id}:
parameters:
- name: id
in: path
required: true
schema:
type: string
get:
operationId: v2_broker_integrations_office365_read
description: ''
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/BrokerOffice365Integration'
'403':
description: Authentication credentials were invalid, absent or insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/GenericError'
'404':
description: Object does not exist or caller has insufficient permissions to access it.
content:
application/json:
schema:
$ref: '#/components/schemas/APIException'
'500':
description: Internal server error.
tags:
- office365 (v2)
summary: Retrieve Office365
/v2/broker/integrations/office365/{id}/reconnect:
parameters:
- name: id
in: path
required: true
schema:
type: string
get:
operationId: v2_broker_integrations_office365_reconnect
summary: Reconnect Office365 integration
description: 'Reconnect the Office365 integration. This will return a URL that the user
should be redirected to.'
responses:
'200':
description: Office365 integration reconnection URL
content:
application/json:
schema:
type: object
properties:
id:
description: Office365 integration ID
type: string
url:
description: Microsoft Authentication URL
type: string
'403':
description: Authentication credentials were invalid, absent or insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/GenericError'
'404':
description: Object does not exist or caller has insufficient permissions to access it.
content:
application/json:
schema:
$ref: '#/components/schemas/APIException'
'500':
description: Internal server error.
tags:
- office365 (v2)
components:
schemas:
IndividualOffice365Integration:
type: object
properties:
id:
title: Id
type: string
format: uuid
readOnly: true
user_email:
title: User email
type: string
format: email
maxLength: 254
user_display_name:
title: User display name
type:
- string
- 'null'
readOnly: true
minLength: 1
integration_status:
title: Integration status
type: string
enum:
- PENDING
- CONNECTED
- DISCONNECTED
readOnly: true
error_message:
title: Error message
type:
- string
- 'null'
readOnly: true
minLength: 1
history_months:
title: History months
description: How far back the initial email sync should go (in months)
type: integer
maximum: 32767
minimum: 0
last_sync_at:
title: Last sync at
type:
- string
- 'null'
format: date-time
readOnly: true
created_at:
title: Created at
type: string
format: date-time
readOnly: true
updated_at:
title: Updated at
type: string
format: date-time
readOnly: true
integrated_by:
title: Integrated by
type:
- integer
- 'null'
readOnly: true
integrated_by_email:
title: Integrated by email
type: string
readOnly: true
minLength: 1
authorization_url:
title: Authorization url
type: string
readOnly: true
ValidationError:
title: Validation Error
type: object
properties:
non_field_errors:
description: List of validation errors not related to any field
type: array
items:
type: string
additionalProperties:
description: A list of error messages for each field that triggered a validation error
type: array
items:
type: string
BrokerOffice365Integration:
required:
- broker
type: object
properties:
id:
title: Id
type: string
format: uuid
readOnly: true
integration_status:
title: Integration status
type: string
enum:
- PENDING
- CONNECTED
- DISCONNECTED
readOnly: true
error_message:
title: Error message
type:
- string
- 'null'
readOnly: true
minLength: 1
created_at:
title: Created at
type: string
format: date-time
readOnly: true
updated_at:
title: Updated at
type: string
format: date-time
readOnly: true
broker:
title: Broker
type: integer
integrated_by:
title: Integrated by
type:
- integer
- 'null'
connection_link:
title: Connection link
type: string
readOnly: true
APIException:
title: Generic API Error
required:
- detail
type: object
properties:
detail:
description: Error details
type: string
GenericError:
title: Generic API Error
required:
- detail
type: object
properties:
detail:
description: Error details
type: string
securitySchemes:
Bearer:
type: apiKey
name: Authorization
in: header
description: JWT access token. Send as `Bearer <token>` or `JWT <token>`.
ApiKey:
type: apiKey
name: Authorization
in: header
description: API key. Send as `Api-Key <key>`.
x-tagGroups:
- name: Agent runtime (v2)
tags:
- agent_runtime (v2)
- name: Analytics
tags:
- analytics
- name: Application
tags:
- 'application: applications'
- 'application: clients'
- name: Application (v2)
tags:
- 'application (v2): applications'
- 'application (v2): coverages'
- name: Ascend
tags:
- ascend
- name: Ascend (v2)
tags:
- ascend (v2)
- name: Authentication
tags:
- Authentication
- auth
- name: Billing (v2)
tags:
- billing (v2)
- name: Broker
tags:
- broker
- broker-ams-integration
- broker-google
- broker-office365
- broker-office365-individual
- 'broker: ai-customization-types'
- 'broker: ai-customizations'
- 'broker: clients'
- 'broker: email_preferences'
- 'broker: proposal-preferences'
- 'broker: take-rates'
- 'broker: user-ai-customizations'
- 'broker: users'
- broker_groups
- broker_settings
- name: Broker (v2)
tags:
- 'broker (v2): applications'
- 'broker (v2): clients'
- 'broker (v2): coverages'
- 'broker (v2): email-templates'
- 'broker (v2): quote-policies'
- 'broker (v2): quotes'
- 'broker (v2): storefront'
- 'broker (v2): team-users'
- name: Business
tags:
- business
- business-broker-users
- business-user
- business_admin
- name: Carrier
tags:
- carrier
- name: Checkout
tags:
- checkout
- name: Email AI
tags:
- email_ai
- name: Email AI (v2)
tags:
- 'email_ai (v2): attachments'
- 'email_ai (v2): carriers'
- 'email_ai (v2): coverage-types'
- 'email_ai (v2): emails'
- 'email_ai (v2): gmail'
- 'email_ai (v2): office365'
- 'email_ai (v2): profiles'
- 'email_ai (v2): wholesalers'
- name: Email AI Agent
tags:
- Email AI Agent
- Email AI Agent - Attachments
- Email AI Agent - Businesses
- Email AI Agent - Entities
- Email AI Agent - Markets
- Email AI Agent - Profiles
- Email AI Agent - Reference Data
- name: Google workspace (v2)
tags:
- google_workspace (v2)
- name: Herald (v2)
tags:
- herald (v2)
- name: Indications (v2)
tags:
- indications (v2)
- name: Insurance (v2)
tags:
- insurance (v2)
- name: Invite
tags:
- invite
- name: Legal
tags:
- legal
- name: Market
tags:
- Markets
- Markets - Business
- name: Market (v2)
tags:
- market (v2)
- name: Office365 (v2)
tags:
- office365 (v2)
- name: Premium finance (v2)
tags:
- premium_finance (v2)
- name: Quote
tags:
- 'quote: applications'
- 'quote: clients'
- 'quote: quotes'
- name: Quote (v2)
tags:
- 'quote (v2): application'
- 'quote (v2): binders'
- 'quote (v2): checkout'
- 'quote (v2): cios'
- 'quote (v2): coverages'
- 'quote (v2): quote-policies'
- 'quote (v2): quotes'
- 'quote (v2): tasks'
- quote_ai (v2)
- name: Reports
tags:
- reports
- name: Reward
tags:
- reward
- name: Risk manager
tags:
- risk_manager
- name: Sanity check AI
tags:
- sanity_check_ai
- name: Storefront (v2)
tags:
- storefront (v2)
- name: Stripe
tags:
- stripe
- name: Suggestion AI
tags:
- suggestion_ai
- name: Treasury (v2)
tags:
- treasury (v2)
- name: User
tags:
- user
- 'user: default-access-role'