repull 0.2.50 → 0.2.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/openapi/v1.json CHANGED
@@ -530,6 +530,15 @@
530
530
  }
531
531
  }
532
532
  },
533
+ "GuestPhoneType": {
534
+ "type": "string",
535
+ "enum": [
536
+ "airbnb_relay",
537
+ "guest"
538
+ ],
539
+ "description": "Whether `phone` is the guest's own number or an Airbnb relay number. Since late October 2026 Airbnb never shares a guest's real phone number. For an Airbnb stay where the listing, host and guest are all in the same country and that country is the US or Canada, Airbnb gives a temporary relay number instead (`airbnb_relay`); every other Airbnb stay has no phone at all. A relay number forwards SMS only (no MMS, RCS or images; about 1,000 characters including Airbnb's prefix, not split). It stops working 48 hours after checkout or when the reservation is cancelled, and it can change during the stay without a reservation webhook (re-read the reservation for the current one). The same relay number is used for other guests of other hosts, so never use it to identify or match a guest. Texting from a number Airbnb does not know: the first message must be the reservation's confirmation code (for example `HM12345678`); text from the host's Airbnb contact number for automatic delivery. `guest` means the number as the channel or the host recorded it.",
540
+ "example": "airbnb_relay"
541
+ },
533
542
  "ReservationPrimaryGuest": {
534
543
  "type": "object",
535
544
  "description": "Inline guest summary resolved by JOIN-ing the `guests` table. Populated for every reservation that has a linked guest row; OMITTED entirely (not null) for owner-blocks / pre-arrival rows / partial-sync gaps. Always optional-chain in SDK consumers.",
@@ -555,7 +564,22 @@
555
564
  "phone": {
556
565
  "type": "string",
557
566
  "nullable": true,
558
- "description": "Primary phone contact (or first non-primary if no primary set)."
567
+ "description": "Primary phone contact (or first non-primary if no primary set). For an Airbnb stay this may be an Airbnb relay number \u2014 check `phoneType`."
568
+ },
569
+ "phoneType": {
570
+ "allOf": [
571
+ {
572
+ "$ref": "#/components/schemas/GuestPhoneType"
573
+ }
574
+ ],
575
+ "description": "Present whenever `phone` is. `airbnb_relay` when `phone` is a temporary Airbnb relay number (SMS only, expires 48h after checkout, shared across hosts, never a guest identifier); `guest` otherwise."
576
+ },
577
+ "phoneExpiresAt": {
578
+ "type": "string",
579
+ "format": "date-time",
580
+ "nullable": true,
581
+ "description": "Only next to an Airbnb relay number: when it stops working (checkout + 48 hours). `null` when Airbnb did not give the checkout time with its offset. A cancelled reservation's relay number stops working at cancellation, whatever this says.",
582
+ "example": "2026-11-22T16:00:00.000Z"
559
583
  },
560
584
  "language": {
561
585
  "type": "string",
@@ -883,6 +907,11 @@
883
907
  },
884
908
  "description": "Door codes for the stay from the PMS's lock manager (today: Guesty Locks Manager), refreshed about every 30 minutes for stays checking in within 14 days that have not checked out. `null` when the reservation's codes are not read from a PMS. `[]` when they are and there is none yet, and for a cancelled stay."
885
909
  },
910
+ "suggestedDoorCode": {
911
+ "type": "string",
912
+ "description": "Airbnb reservations only, when Airbnb sends it: the door code Airbnb suggests \u2014 the last 4 digits of the booker's verified phone number, or random digits when there is none. Use it instead of deriving a code from the guest's phone, which Airbnb no longer shares. Omitted on every other reservation.",
913
+ "example": "5446"
914
+ },
886
915
  "primaryGuest": {
887
916
  "allOf": [
888
917
  {
@@ -993,7 +1022,16 @@
993
1022
  "phone": {
994
1023
  "type": "string",
995
1024
  "nullable": true,
996
- "description": "Primary phone contact (or first non-primary if no primary set)."
1025
+ "description": "Primary phone contact (or first non-primary if no primary set). May be an Airbnb relay number \u2014 check `phoneType`."
1026
+ },
1027
+ "phoneType": {
1028
+ "allOf": [
1029
+ {
1030
+ "$ref": "#/components/schemas/GuestPhoneType"
1031
+ }
1032
+ ],
1033
+ "nullable": true,
1034
+ "description": "`airbnb_relay` when `phone` is a temporary Airbnb relay number (SMS only, expires 48h after checkout, shared across hosts, never a guest identifier); `guest` otherwise; `null` when there is no phone."
997
1035
  },
998
1036
  "email": {
999
1037
  "type": "string",
@@ -1049,6 +1087,14 @@
1049
1087
  "type": "string",
1050
1088
  "format": "date-time",
1051
1089
  "nullable": true
1090
+ },
1091
+ "phoneType": {
1092
+ "allOf": [
1093
+ {
1094
+ "$ref": "#/components/schemas/GuestPhoneType"
1095
+ }
1096
+ ],
1097
+ "description": "Phone contacts only: `airbnb_relay` when this is a temporary Airbnb relay number (SMS only, expires 48h after checkout, shared across hosts, never a guest identifier); `guest` otherwise."
1052
1098
  }
1053
1099
  }
1054
1100
  },
@@ -1146,7 +1192,17 @@
1146
1192
  },
1147
1193
  "phone": {
1148
1194
  "type": "string",
1149
- "nullable": true
1195
+ "nullable": true,
1196
+ "description": "Primary phone contact. May be an Airbnb relay number \u2014 check `phoneType`."
1197
+ },
1198
+ "phoneType": {
1199
+ "allOf": [
1200
+ {
1201
+ "$ref": "#/components/schemas/GuestPhoneType"
1202
+ }
1203
+ ],
1204
+ "nullable": true,
1205
+ "description": "`airbnb_relay` when `phone` is a temporary Airbnb relay number; `guest` otherwise; `null` when there is no phone."
1150
1206
  },
1151
1207
  "email": {
1152
1208
  "type": "string",
@@ -1502,12 +1558,12 @@
1502
1558
  },
1503
1559
  "status": {
1504
1560
  "type": "string",
1505
- "description": "Delivery state. Inbound messages are `received`. An outbound message is `sending` while it is queued to the channel, `sent` once the channel accepted it, or `failed`. Only `sent` (or `received`) means the guest can see it."
1561
+ "description": "Delivery state. Inbound messages are `received`. An outbound message is `sending` while it is handed to the channel, `queued` when the channel was busy and Repull is still delivering it in the background (Vrbo), `sent` once the channel accepted it, or `failed`. Only `sent` (or `received`) means the guest can see it. A change from `queued` is sent as `conversation.message.status_changed`."
1506
1562
  },
1507
1563
  "statusReason": {
1508
1564
  "type": "string",
1509
1565
  "nullable": true,
1510
- "description": "Why a message is still `sending` or `failed`, in plain words. `null` otherwise."
1566
+ "description": "Why a message is still `sending` or `queued`, or why it `failed`, in plain words. `null` otherwise."
1511
1567
  },
1512
1568
  "senderType": {
1513
1569
  "type": "string",
@@ -2580,7 +2636,16 @@
2580
2636
  "type": "string",
2581
2637
  "format": "date-time",
2582
2638
  "nullable": true,
2583
- "description": "Vrbo only. When Vrbo's first notification reached `notificationEmail`, i.e. the host added it with notifications on. `null` until then."
2639
+ "deprecated": true,
2640
+ "description": "Deprecated: use `notifications`. Vrbo only. When Vrbo's FIRST notification reached `notificationEmail`; it stays set even if notifications later stop. `null` until then."
2641
+ },
2642
+ "notifications": {
2643
+ "allOf": [
2644
+ {
2645
+ "$ref": "#/components/schemas/VrboNotifications"
2646
+ }
2647
+ ],
2648
+ "description": "Vrbo only. Whether Vrbo's notification emails reach Repull now (`state`), when the last one did, and the address to add. When `state` is `missing`, ask the host to add `address` on Vrbo; `account.notifications_missing` is sent when that happens."
2584
2649
  },
2585
2650
  "calendar": {
2586
2651
  "nullable": true,
@@ -3027,6 +3092,7 @@
3027
3092
  "reservation.updated",
3028
3093
  "reservation.cancelled",
3029
3094
  "reservation.message.received",
3095
+ "conversation.message.status_changed",
3030
3096
  "reservation.message.sent",
3031
3097
  "reservation.message.updated",
3032
3098
  "reservation.message.read",
@@ -3055,6 +3121,7 @@
3055
3121
  "account.import.failed",
3056
3122
  "account.units.added",
3057
3123
  "account.calendar_access_changed",
3124
+ "account.notifications_missing",
3058
3125
  "review.created",
3059
3126
  "review.responded",
3060
3127
  "ai.operation.completed",
@@ -6507,6 +6574,180 @@
6507
6574
  },
6508
6575
  "description": "Another tool (such as a PMS) started or stopped managing a Vrbo account's calendar. Started: calendar sync is now off for every unit of the account. Stopped: nothing is switched back on; turn it on with `POST /v1/connections/{id}/mappings` (`calendarSync: true`)."
6509
6576
  },
6577
+ "VrboNotifications": {
6578
+ "type": "object",
6579
+ "description": "Whether Vrbo's notification emails for this account reach Repull. Each one brings a new guest message or booking in within about a minute; without them Repull relies on its scheduled check, which is slower.",
6580
+ "required": [
6581
+ "state",
6582
+ "lastReceivedAt",
6583
+ "address"
6584
+ ],
6585
+ "properties": {
6586
+ "state": {
6587
+ "type": "string",
6588
+ "description": "`active`: notifications arrive for this account's guest messages. `missing`: Repull found new guest messages and no notification came for them \u2014 ask the host to add `address` on Vrbo (or turn its notifications back on). `unknown`: no guest messages yet to judge by."
6589
+ },
6590
+ "lastReceivedAt": {
6591
+ "type": "string",
6592
+ "format": "date-time",
6593
+ "nullable": true,
6594
+ "description": "When the last Vrbo notification reached `address`. `null` when none ever has."
6595
+ },
6596
+ "address": {
6597
+ "type": "string",
6598
+ "nullable": true,
6599
+ "example": "in+vrbo-1234-321@repull.dev",
6600
+ "description": "The address the host adds on Vrbo as a secondary email, with message and reservation notifications on."
6601
+ }
6602
+ }
6603
+ },
6604
+ "ConversationMessageStatusChangedPayload": {
6605
+ "type": "object",
6606
+ "required": [
6607
+ "conversationId",
6608
+ "messageId",
6609
+ "status",
6610
+ "statusReason"
6611
+ ],
6612
+ "description": "Payload for `conversation.message.status_changed`: a message you sent changed delivery status after the send call returned \u2014 a Vrbo reply accepted as `queued` (`202`) was delivered (`sent`) or gave up (`failed`).",
6613
+ "properties": {
6614
+ "conversationId": {
6615
+ "type": "string",
6616
+ "example": "549555",
6617
+ "description": "The conversation (`GET /v1/conversations/{id}`)."
6618
+ },
6619
+ "messageId": {
6620
+ "type": "string",
6621
+ "example": "1861207",
6622
+ "description": "The message, as `id` on the send response and on `GET /v1/conversations/{id}/messages`."
6623
+ },
6624
+ "status": {
6625
+ "type": "string",
6626
+ "description": "The new delivery status."
6627
+ },
6628
+ "statusReason": {
6629
+ "type": "string",
6630
+ "nullable": true,
6631
+ "description": "Why it `failed`, in plain words. `null` when `sent`."
6632
+ }
6633
+ }
6634
+ },
6635
+ "ConversationMessageStatusChangedEvent": {
6636
+ "type": "object",
6637
+ "required": [
6638
+ "event",
6639
+ "eventId",
6640
+ "apiVersion",
6641
+ "timestamp",
6642
+ "data"
6643
+ ],
6644
+ "properties": {
6645
+ "event": {
6646
+ "type": "string",
6647
+ "description": "The event name. This field is `event`, not `type`."
6648
+ },
6649
+ "eventId": {
6650
+ "type": "string",
6651
+ "format": "uuid",
6652
+ "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
6653
+ },
6654
+ "apiVersion": {
6655
+ "type": "string",
6656
+ "example": "2026-04"
6657
+ },
6658
+ "timestamp": {
6659
+ "type": "string",
6660
+ "format": "date-time",
6661
+ "description": "When this delivery was built."
6662
+ },
6663
+ "account": {
6664
+ "$ref": "#/components/schemas/WebhookEventAccount"
6665
+ },
6666
+ "data": {
6667
+ "$ref": "#/components/schemas/ConversationMessageStatusChangedPayload"
6668
+ }
6669
+ },
6670
+ "description": "A message you sent was delivered or gave up after the send call returned. Update the message you show from `status` and `statusReason`."
6671
+ },
6672
+ "AccountNotificationsMissingPayload": {
6673
+ "type": "object",
6674
+ "required": [
6675
+ "workspaceId",
6676
+ "provider",
6677
+ "accountId",
6678
+ "connectionId",
6679
+ "notifications",
6680
+ "detectedAt"
6681
+ ],
6682
+ "description": "Payload for `account.notifications_missing`: a Vrbo account had new guest messages and no notification email arrived for them.",
6683
+ "properties": {
6684
+ "workspaceId": {
6685
+ "type": "integer"
6686
+ },
6687
+ "provider": {
6688
+ "type": "string"
6689
+ },
6690
+ "accountId": {
6691
+ "type": "string",
6692
+ "nullable": true,
6693
+ "description": "Vrbo's account number (`accounts[].externalAccountId` on `GET /v1/connect/vrbo-login`)."
6694
+ },
6695
+ "connectionId": {
6696
+ "type": "integer",
6697
+ "nullable": true,
6698
+ "description": "The workspace's Vrbo connection record."
6699
+ },
6700
+ "notifications": {
6701
+ "$ref": "#/components/schemas/VrboNotifications"
6702
+ },
6703
+ "detectedAt": {
6704
+ "type": "string",
6705
+ "format": "date-time"
6706
+ },
6707
+ "docsUrl": {
6708
+ "type": "string",
6709
+ "format": "uri",
6710
+ "example": "https://repull.dev/docs/channels/vrbo/notifications"
6711
+ }
6712
+ }
6713
+ },
6714
+ "AccountNotificationsMissingEvent": {
6715
+ "type": "object",
6716
+ "required": [
6717
+ "event",
6718
+ "eventId",
6719
+ "apiVersion",
6720
+ "timestamp",
6721
+ "data"
6722
+ ],
6723
+ "properties": {
6724
+ "event": {
6725
+ "type": "string",
6726
+ "description": "The event name. This field is `event`, not `type`."
6727
+ },
6728
+ "eventId": {
6729
+ "type": "string",
6730
+ "format": "uuid",
6731
+ "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
6732
+ },
6733
+ "apiVersion": {
6734
+ "type": "string",
6735
+ "example": "2026-04"
6736
+ },
6737
+ "timestamp": {
6738
+ "type": "string",
6739
+ "format": "date-time",
6740
+ "description": "When this delivery was built."
6741
+ },
6742
+ "account": {
6743
+ "$ref": "#/components/schemas/WebhookEventAccount"
6744
+ },
6745
+ "data": {
6746
+ "$ref": "#/components/schemas/AccountNotificationsMissingPayload"
6747
+ }
6748
+ },
6749
+ "description": "A Vrbo account's notification emails are not arriving. Ask the host to add `data.notifications.address` on Vrbo as a secondary email with message and reservation notifications on."
6750
+ },
6510
6751
  "AccountUnitsAddedEvent": {
6511
6752
  "type": "object",
6512
6753
  "required": [
@@ -7239,6 +7480,9 @@
7239
7480
  {
7240
7481
  "$ref": "#/components/schemas/ReservationMessageReceivedEvent"
7241
7482
  },
7483
+ {
7484
+ "$ref": "#/components/schemas/ConversationMessageStatusChangedEvent"
7485
+ },
7242
7486
  {
7243
7487
  "$ref": "#/components/schemas/ReservationMessageSentEvent"
7244
7488
  },
@@ -7323,6 +7567,9 @@
7323
7567
  {
7324
7568
  "$ref": "#/components/schemas/AccountCalendarAccessChangedEvent"
7325
7569
  },
7570
+ {
7571
+ "$ref": "#/components/schemas/AccountNotificationsMissingEvent"
7572
+ },
7326
7573
  {
7327
7574
  "$ref": "#/components/schemas/ReviewCreatedEvent"
7328
7575
  },
@@ -7364,6 +7611,7 @@
7364
7611
  "reservation.updated": "#/components/schemas/ReservationUpdatedEvent",
7365
7612
  "reservation.cancelled": "#/components/schemas/ReservationCancelledEvent",
7366
7613
  "reservation.message.received": "#/components/schemas/ReservationMessageReceivedEvent",
7614
+ "conversation.message.status_changed": "#/components/schemas/ConversationMessageStatusChangedEvent",
7367
7615
  "reservation.message.sent": "#/components/schemas/ReservationMessageSentEvent",
7368
7616
  "reservation.message.updated": "#/components/schemas/ReservationMessageUpdatedEvent",
7369
7617
  "reservation.message.read": "#/components/schemas/ReservationMessageReadEvent",
@@ -7392,6 +7640,7 @@
7392
7640
  "account.import.failed": "#/components/schemas/AccountImportFailedEvent",
7393
7641
  "account.units.added": "#/components/schemas/AccountUnitsAddedEvent",
7394
7642
  "account.calendar_access_changed": "#/components/schemas/AccountCalendarAccessChangedEvent",
7643
+ "account.notifications_missing": "#/components/schemas/AccountNotificationsMissingEvent",
7395
7644
  "review.created": "#/components/schemas/ReviewCreatedEvent",
7396
7645
  "review.responded": "#/components/schemas/ReviewRespondedEvent",
7397
7646
  "ai.operation.completed": "#/components/schemas/AiOperationCompletedEvent",
@@ -16140,7 +16389,8 @@
16140
16389
  },
16141
16390
  "status": {
16142
16391
  "type": "string",
16143
- "example": "sent"
16392
+ "example": "sent",
16393
+ "description": "`sent`: delivered. `queued` (with HTTP `202`): recorded, and still being delivered in the background because the channel was busy (Vrbo) \u2014 do not resend; the outcome arrives as the message's `status` on `GET /v1/conversations/{id}/messages` and as `conversation.message.status_changed`."
16144
16394
  },
16145
16395
  "direction": {
16146
16396
  "type": "string"
@@ -20333,7 +20583,7 @@
20333
20583
  "post": {
20334
20584
  "operationId": "send_conversation_message",
20335
20585
  "summary": "Send a message to the guest",
20336
- "description": "Sends a message to the guest on this conversation and records it in the thread.\n\nOmit `channel` and the message goes out on whichever channel the conversation already uses (Airbnb, Booking.com, VRBO, SMS, email or the direct-booking site) \u2014 that is the right default. Pass `channel` only to force a specific one.\n\nThe message is attributed to the API: it is recorded with `aiGenerated` false so an API send is never counted as an automated reply.\n\n### Airbnb rewrites links \u2014 check `contentRewritten`\n\nAirbnb rejects guest messages containing a link, an email address or a phone number, and names the offending text. When that happens the offending fragment is stripped and the remainder is re-sent once, which means **the guest receives a message that is not the one you wrote**. Reporting that as a plain success would be a lie, so every response carries `contentRewritten`; when it is `true`, `deliveredContent` is the text that actually reached the guest. Check it before assuming your message went out verbatim.\n\nWhen the text cannot be salvaged (the link is most of the message) nothing is delivered and the call returns `422 message_not_sent` with the channel's verbatim refusal in `statusReason`. `message_not_sent` only ever means the channel refused: a fault on Repull's side (a dropped database connection, a timeout) is `503 internal_error` with `sent: false` when nothing was delivered \u2014 retry it unchanged with the same `Idempotency-Key`.\n\nSend `Idempotency-Key` \u2014 without it, retrying after a network timeout sends the guest the same message twice.\n\n### Attachments\n\nSend files with `attachments: [{ url, contentType?, filename? }]` \u2014 public `https://` URLs, up to 5 per request, 10 MB each. `message` may be omitted when there are attachments (except on Booking.com). Repull downloads each file, reads its real type from the bytes, keeps a durable copy and delivers it through the channel's own file flow. **Every file is checked before anything is sent**: if one is unreachable, too large or of a type the channel refuses, the call returns 422 naming the file (`index`) and the guest receives nothing.\n\n| Channel | Accepted types | Text | How it arrives |\n|---|---|---|---|\n| Airbnb | JPEG, PNG, GIF, WebP (converted to JPEG), MP4, QuickTime | optional | each file as its own message, then the text as a separate message |\n| Booking.com | JPEG, PNG | **required** | one message carrying the text and every file |\n| VRBO, SMS, email, direct-booking site chat | \u2014 | \u2014 | `422 attachments_not_supported`, nothing sent |\n\nAirbnb does not allow files in pre-booking (inquiry) conversations; that refusal comes back as `422 message_not_sent`. Because Airbnb delivers files one message at a time, a later file can be refused after earlier ones arrived \u2014 that returns `422 message_partially_sent` with `parts` saying exactly which messages reached the guest; resend only the rest.\n\nThe response's `attachments` lists each file's durable `url`, and `parts` lists every channel message the send produced. Read-back (`GET /v1/conversations/{id}/messages`) shows the same files in each message's `attachments`.\n\n**Inactive listings:** a conversation that belongs to an inactive listing returns `403 listing_inactive` and no message is sent. Activate the listing first.",
20586
+ "description": "Sends a message to the guest on this conversation and records it in the thread.\n\nOmit `channel` and the message goes out on whichever channel the conversation already uses (Airbnb, Booking.com, VRBO, SMS, email or the direct-booking site) \u2014 that is the right default. Pass `channel` only to force a specific one.\n\nThe message is attributed to the API: it is recorded with `aiGenerated` false so an API send is never counted as an automated reply.\n\n### Airbnb rewrites links \u2014 check `contentRewritten`\n\nAirbnb rejects guest messages containing a link, an email address or a phone number, and names the offending text. When that happens the offending fragment is stripped and the remainder is re-sent once, which means **the guest receives a message that is not the one you wrote**. Reporting that as a plain success would be a lie, so every response carries `contentRewritten`; when it is `true`, `deliveredContent` is the text that actually reached the guest. Check it before assuming your message went out verbatim.\n\nWhen the text cannot be salvaged (the link is most of the message) nothing is delivered and the call returns `422 message_not_sent` with the channel's verbatim refusal in `statusReason`. `message_not_sent` only ever means the channel refused: a fault on Repull's side (a dropped database connection, a timeout) is `503 internal_error` with `sent: false` when nothing was delivered \u2014 retry it unchanged with the same `Idempotency-Key`.\n\nSend `Idempotency-Key` \u2014 without it, retrying after a network timeout sends the guest the same message twice.\n\n### Vrbo: `202` while Vrbo is busy\n\nA Vrbo reply is delivered in the call when Vrbo takes it (about 20 seconds at most) and returns `200` with `status: \"sent\"`. When Vrbo is busy, the reply is recorded and delivered in the background: the call returns **`202` with `status: \"queued\"`** and the message `id`. Do not send it again \u2014 a retry with the same `Idempotency-Key` returns the same `202`. The outcome arrives as the message's `status` on `GET /v1/conversations/{id}/messages` (`sent`, or `failed` with `statusReason`) and as the `conversation.message.status_changed` webhook.\n\n### Attachments\n\nSend files with `attachments: [{ url, contentType?, filename? }]` \u2014 public `https://` URLs, up to 5 per request, 10 MB each. `message` may be omitted when there are attachments (except on Booking.com). Repull downloads each file, reads its real type from the bytes, keeps a durable copy and delivers it through the channel's own file flow. **Every file is checked before anything is sent**: if one is unreachable, too large or of a type the channel refuses, the call returns 422 naming the file (`index`) and the guest receives nothing.\n\n| Channel | Accepted types | Text | How it arrives |\n|---|---|---|---|\n| Airbnb | JPEG, PNG, GIF, WebP (converted to JPEG), MP4, QuickTime | optional | each file as its own message, then the text as a separate message |\n| Booking.com | JPEG, PNG | **required** | one message carrying the text and every file |\n| VRBO, SMS, email, direct-booking site chat | \u2014 | \u2014 | `422 attachments_not_supported`, nothing sent |\n\nAirbnb does not allow files in pre-booking (inquiry) conversations; that refusal comes back as `422 message_not_sent`. Because Airbnb delivers files one message at a time, a later file can be refused after earlier ones arrived \u2014 that returns `422 message_partially_sent` with `parts` saying exactly which messages reached the guest; resend only the rest.\n\nThe response's `attachments` lists each file's durable `url`, and `parts` lists every channel message the send produced. Read-back (`GET /v1/conversations/{id}/messages`) shows the same files in each message's `attachments`.\n\n**Inactive listings:** a conversation that belongs to an inactive listing returns `403 listing_inactive` and no message is sent. Activate the listing first.",
20337
20587
  "tags": [
20338
20588
  "Conversations"
20339
20589
  ],
@@ -20450,6 +20700,34 @@
20450
20700
  }
20451
20701
  }
20452
20702
  },
20703
+ "202": {
20704
+ "description": "Accepted, not yet delivered (Vrbo, while Vrbo is busy): the message is recorded with `status: \"queued\"` and delivered in the background. Do not resend \u2014 the same `Idempotency-Key` replays this `202`. Follow the outcome on `GET /v1/conversations/{id}/messages` (`status` becomes `sent`, or `failed` with `statusReason`) or the `conversation.message.status_changed` webhook.",
20705
+ "content": {
20706
+ "application/json": {
20707
+ "schema": {
20708
+ "$ref": "#/components/schemas/SendMessageResponse"
20709
+ },
20710
+ "examples": {
20711
+ "vrboQueued": {
20712
+ "summary": "Vrbo was busy: recorded and delivered in the background",
20713
+ "value": {
20714
+ "id": "1861207",
20715
+ "conversationId": "549555",
20716
+ "externalMessageId": null,
20717
+ "channel": "vrbo",
20718
+ "status": "queued",
20719
+ "direction": "outbound",
20720
+ "contentRewritten": false,
20721
+ "submittedContent": "Hi Ximena, the gate code is 4821.",
20722
+ "deliveredContent": null,
20723
+ "statusReason": "Vrbo is busy right now; the reply will be delivered in the background.",
20724
+ "attachments": []
20725
+ }
20726
+ }
20727
+ }
20728
+ }
20729
+ }
20730
+ },
20453
20731
  "401": {
20454
20732
  "$ref": "#/components/responses/Unauthorized"
20455
20733
  },
@@ -20682,7 +20960,7 @@
20682
20960
  }
20683
20961
  },
20684
20962
  "503": {
20685
- "description": "A temporary fault on Repull's side \u2014 never a verdict on the message. `internal_error`: the send failed inside Repull (a dropped database connection, a timeout) before the channel refused anything. `sent` says whether the message reached the channel: with `messageId: null` and `sent: false` nothing was delivered or recorded, and retrying the same request with the same `Idempotency-Key` after `retry_after` seconds sends it once. With a `messageId`, check that message in `GET /v1/conversations/{id}/messages` before resending. `attachment_storage_failed`: a file could not be stored for delivery; nothing was sent, retry the same way. A 503 is never stored against the `Idempotency-Key`, so the retry runs for real. Do not edit the text: it was not refused.",
20963
+ "description": "A temporary fault on Repull's side \u2014 never a verdict on the message. `internal_error`: the send failed inside Repull (a dropped database connection, a timeout) before the channel refused anything. With `sent: null` Repull did not get the result in time and the message may still be delivered: check `GET /v1/conversations/{id}/messages` before resending. `sent` says whether the message reached the channel: with `messageId: null` and `sent: false` nothing was delivered or recorded, and retrying the same request with the same `Idempotency-Key` after `retry_after` seconds sends it once. With a `messageId`, check that message in `GET /v1/conversations/{id}/messages` before resending. `attachment_storage_failed`: a file could not be stored for delivery; nothing was sent, retry the same way. A 503 is never stored against the `Idempotency-Key`, so the retry runs for real. Do not edit the text: it was not refused.",
20686
20964
  "content": {
20687
20965
  "application/json": {
20688
20966
  "schema": {
@@ -32250,7 +32528,7 @@
32250
32528
  "get": {
32251
32529
  "operationId": "get_airbnb_booking_settings",
32252
32530
  "summary": "Get Airbnb booking settings",
32253
- "description": "Read how an Airbnb listing takes bookings and what happens when a guest cancels: booking mode, Instant Book state, the good-track-record requirement, check-in/check-out times, advance notice, preparation time, booking window, the short-stay and long-stay cancellation policies, and the non-refundable option.\n\n**This is Repull's stored copy, not a live call to Airbnb.** Values come from the local Airbnb mirror that the sync workers fill, so the response always carries `dataFreshness` \u2014 check `dataFreshness.stale` (and `dataFreshness.accounts[]` when the workspace has several Airbnb accounts) before treating a value as current.\n\n**Not exposed by Airbnb.** The pre-reservation message and automatic stay extension have no field on Airbnb's `booking_settings` resource, so neither can be read or written here; set the pre-reservation message in the Airbnb host dashboard, and handle extensions through `/v1/channels/airbnb/alterations`. Airbnb also expresses the same-day cutoff only as whole hours of advance notice, so `advanceNotice.hours` is as precise as the cutoff gets.\n\nReturns `404` when the listing has no Airbnb connection in this workspace, and `403 listing_inactive` when the listing is inactive \u2014 an inactive listing keeps syncing but cannot be read or changed through the API until it is activated.",
32531
+ "description": "Read how an Airbnb listing takes bookings and what happens when a guest cancels: booking mode, Instant Book state, the good-track-record requirement, check-in/check-out times, advance notice, preparation time, booking window, the short-stay and long-stay cancellation policies, and the non-refundable option.\n\n**This is Repull's stored copy, not a live call to Airbnb.** Values come from the local Airbnb mirror that the sync workers fill, so the response always carries `dataFreshness` \u2014 check `dataFreshness.stale` (and `dataFreshness.accounts[]` when the workspace has several Airbnb accounts) before treating a value as current.\n\n**Not exposed by Airbnb.** The pre-reservation message and automatic stay extension have no field on Airbnb's `booking_settings` resource, so neither can be read or written here; set the pre-reservation message in the Airbnb host dashboard, and handle extensions through `/v1/channels/airbnb/alterations`. The same-day cutoff is Airbnb's advance-notice hours counted back from 11:59 PM on the check-in day: read it as `advanceNotice.sameDayCutoff` (e.g. `23:00`) or `advanceNotice.hours` (e.g. `1`), and write either one.\n\nReturns `404` when the listing has no Airbnb connection in this workspace, and `403 listing_inactive` when the listing is inactive \u2014 an inactive listing keeps syncing but cannot be read or changed through the API until it is activated.",
32254
32532
  "tags": [
32255
32533
  "Airbnb"
32256
32534
  ],
@@ -32372,12 +32650,18 @@
32372
32650
  "hours": {
32373
32651
  "type": "integer",
32374
32652
  "nullable": true,
32375
- "description": "Whole hours of notice. `0` allows same-day bookings."
32653
+ "description": "Airbnb's advance notice: 0-24, 48, 72 or 168. Airbnb counts it back from 11:59 PM on the check-in day, in the listing's time zone, so 0-23 is a same-day cutoff: `0` = same-day bookings until midnight, `1` = until 11 PM, `3` = until 9 PM. `24` and above = no same-day bookings."
32376
32654
  },
32377
32655
  "sameDayBookingsAllowed": {
32378
32656
  "type": "boolean",
32379
32657
  "nullable": true,
32380
- "description": "Derived: `hours === 0`."
32658
+ "description": "Derived: `hours < 24`."
32659
+ },
32660
+ "sameDayCutoff": {
32661
+ "type": "string",
32662
+ "nullable": true,
32663
+ "example": "23:00",
32664
+ "description": "Derived: the last time a same-day booking is accepted, `HH:mm` in the listing's time (`00:00` = midnight). `null` when same-day bookings are off."
32381
32665
  },
32382
32666
  "allowRequestToBook": {
32383
32667
  "type": "boolean",
@@ -32631,13 +32915,49 @@
32631
32915
  "advanceNotice": {
32632
32916
  "type": "object",
32633
32917
  "additionalProperties": false,
32634
- "description": "Send `hours`, `allowRequestToBook`, or both. The half you omit keeps the value Airbnb currently holds.",
32918
+ "description": "Send `hours` (or `sameDayCutoff`), `allowRequestToBook`, or both. The half you omit keeps the value Airbnb currently holds. `hours` and `sameDayCutoff` are the same setting: send one.",
32635
32919
  "properties": {
32636
32920
  "hours": {
32637
32921
  "type": "integer",
32638
32922
  "nullable": true,
32639
- "minimum": 0,
32640
- "maximum": 168
32923
+ "enum": [
32924
+ 0,
32925
+ 1,
32926
+ 2,
32927
+ 3,
32928
+ 4,
32929
+ 5,
32930
+ 6,
32931
+ 7,
32932
+ 8,
32933
+ 9,
32934
+ 10,
32935
+ 11,
32936
+ 12,
32937
+ 13,
32938
+ 14,
32939
+ 15,
32940
+ 16,
32941
+ 17,
32942
+ 18,
32943
+ 19,
32944
+ 20,
32945
+ 21,
32946
+ 22,
32947
+ 23,
32948
+ 24,
32949
+ 48,
32950
+ 72,
32951
+ 168
32952
+ ],
32953
+ "description": "Counted back from 11:59 PM on the check-in day (listing time): `0` = same-day bookings until midnight, `1` = until 11 PM, `24` = no same-day bookings."
32954
+ },
32955
+ "sameDayCutoff": {
32956
+ "type": "string",
32957
+ "nullable": true,
32958
+ "pattern": "^([01][0-9]|2[0-3]):00$",
32959
+ "example": "23:00",
32960
+ "description": "The last time a same-day booking is accepted, whole hours in the listing's time (`23:00` = 11 PM, `00:00` = midnight). Converted to `hours` (`23:00` = 1)."
32641
32961
  },
32642
32962
  "allowRequestToBook": {
32643
32963
  "type": "boolean",
@@ -32805,12 +33125,18 @@
32805
33125
  "hours": {
32806
33126
  "type": "integer",
32807
33127
  "nullable": true,
32808
- "description": "Whole hours of notice. `0` allows same-day bookings."
33128
+ "description": "Airbnb's advance notice: 0-24, 48, 72 or 168. Airbnb counts it back from 11:59 PM on the check-in day, in the listing's time zone, so 0-23 is a same-day cutoff: `0` = same-day bookings until midnight, `1` = until 11 PM, `3` = until 9 PM. `24` and above = no same-day bookings."
32809
33129
  },
32810
33130
  "sameDayBookingsAllowed": {
32811
33131
  "type": "boolean",
32812
33132
  "nullable": true,
32813
- "description": "Derived: `hours === 0`."
33133
+ "description": "Derived: `hours < 24`."
33134
+ },
33135
+ "sameDayCutoff": {
33136
+ "type": "string",
33137
+ "nullable": true,
33138
+ "example": "23:00",
33139
+ "description": "Derived: the last time a same-day booking is accepted, `HH:mm` in the listing's time (`00:00` = midnight). `null` when same-day bookings are off."
32814
33140
  },
32815
33141
  "allowRequestToBook": {
32816
33142
  "type": "boolean",
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: repull
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.50
4
+ version: 0.2.51
5
5
  platform: ruby
6
6
  authors:
7
7
  - Ivan Nikolov
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2026-11-17 00:00:00.000000000 Z
11
+ date: 2026-11-18 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: typhoeus
@@ -114,6 +114,8 @@ files:
114
114
  - lib/repull/models/account_import_stage.rb
115
115
  - lib/repull/models/account_import_started_event.rb
116
116
  - lib/repull/models/account_import_started_payload.rb
117
+ - lib/repull/models/account_notifications_missing_event.rb
118
+ - lib/repull/models/account_notifications_missing_payload.rb
117
119
  - lib/repull/models/account_units_added_event.rb
118
120
  - lib/repull/models/account_units_added_payload.rb
119
121
  - lib/repull/models/account_units_added_payload_hotels_inner.rb
@@ -292,6 +294,8 @@ files:
292
294
  - lib/repull/models/conversation_host.rb
293
295
  - lib/repull/models/conversation_list_response.rb
294
296
  - lib/repull/models/conversation_message_attachment.rb
297
+ - lib/repull/models/conversation_message_status_changed_event.rb
298
+ - lib/repull/models/conversation_message_status_changed_payload.rb
295
299
  - lib/repull/models/create_airbnb_listing_room_request.rb
296
300
  - lib/repull/models/create_airbnb_offer_request.rb
297
301
  - lib/repull/models/create_airbnb_offer_request_guest_details.rb
@@ -403,6 +407,7 @@ files:
403
407
  - lib/repull/models/guest_flag.rb
404
408
  - lib/repull/models/guest_list_response.rb
405
409
  - lib/repull/models/guest_note.rb
410
+ - lib/repull/models/guest_phone_type.rb
406
411
  - lib/repull/models/guest_profile.rb
407
412
  - lib/repull/models/guest_reservations_summary.rb
408
413
  - lib/repull/models/guest_update_request.rb
@@ -878,6 +883,7 @@ files:
878
883
  - lib/repull/models/vrbo_listing.rb
879
884
  - lib/repull/models/vrbo_login200_response.rb
880
885
  - lib/repull/models/vrbo_login_request.rb
886
+ - lib/repull/models/vrbo_notifications.rb
881
887
  - lib/repull/models/vrbo_reservation.rb
882
888
  - lib/repull/models/vrbo_reservation_list_response.rb
883
889
  - lib/repull/models/webhook_delivery.rb