> ## Documentation Index
> Fetch the complete documentation index at: https://docs.surge.app/llms.txt
> Use this file to discover all available pages before exploring further.

# phone_number.imported

> Fires when a phone number is imported into Surge from an external provider.

Fires when a phone number is imported into Surge from an external provider, such as through porting or hosting. The event includes the number's ID, E.164 format, type, and any campaign attachment details available at import time.

Imported numbers are not necessarily ready for production messaging yet. If a campaign is associated with the number, check `data.campaign.attachment_status`. When attachment completes, Surge fires [`phone_number.attached_to_campaign`](/api-reference/webhooks/phone_number/attached_to_campaign) instead.

## Common use case

Use `phone_number.imported` to update your own records when a ported or hosted number becomes available in Surge, for example, to notify a customer that their import finished or to start tracking campaign attachment for that number.


## OpenAPI

````yaml webhook phoneNumberImported
openapi: 3.1.1
info:
  title: Surge
  version: '1.0'
servers:
  - url: https://api.surge.app
security:
  - authorization: []
paths: {}
components:
  securitySchemes:
    authorization:
      bearerFormat: Surge API token
      scheme: bearer
      type: http

````